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CSURSE DESCRIPTION 
Multeies Virtual Memory Analvsis and Metering 


Five Days 

Personnel recuir ine analiysis-level knowlecge ci 
Multics virtuai memory implementation, metering and 
tuning. Especially useful for personnel concerned 


with maximizing system performance... 

The Multics supervisor is iogically divided into seven 
distinct subsystems. This course Getaiis the 
functions performec (anc the cate bases maintained) by 


five of these subsystems: Volume Manacement, Name anc 

Address Space Management, Directory Control, Secqment 

Control, and Page Control Knowledge of the virtual 

memory implementation gives the student insight into 

the metering anc tuning cf the system. Other popap Wet] 
include overviews cf the Multics system hardware, the 

Muitics Supervi Sor, and a comparison with other memory 

management tcechnicques. Question end answer periods 

are given caily te reinforce the material presented. 

Upen completion ec: this course, the student shoulc be 

able to: 

i. Understand the functions cf the Multies superviser 
Sudsystems, especiaily those sussystems «hich 
implement the Multics virtual memory. 

2. Make optima: design choices when writing system 
applications to run in the Multics environmen:. 

3. Evaluate anc tune che system's performance Dy 
anaivzing the system's virtual memory meters. 
Multics Sussystem Programming (FIED), Source Level 
Dedugging & The Process Environment Vege.)  16e 

equivalent experience. 

System Hardware Components 

Volume (Disk) Management 

Name Ssace/AcGress Space Management 

Directery, Secment anc Pace Centrol 


Memory Management Techniques 
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MAGOR DESIGN GOAL 


® MULTIPLEAED INFORMATION AND COMPUTING SERVICE (MULTICS) 


@ MULTICS WAS ONE OF THE FIRST OPERATING SYSTEMS. -TO BE THOROUGHLY 
DESIGNED FROM THE TOP DOWN) THE DEVELOPERS: 


] CREATED A SYSTEM WHICH WOULD SATISFY TEESE GOALS 


[ DEVELOPED GENERAL SOLUTIONS INSTEAD OF SPECIFIC SOLUTIONS. 
(MAKING THE PRODUCT EXTENDABLE) ie 


f FRODUCED A VIABLE AND MARKETABLE PRODUCT 
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VIRTUAL MEMORY ORGANI ZATION 


@ MOTIVATION 


INFORMATION STORED ON-LINE IN LARGE INFORMATION UTILITIES OFTEN 
EXCEEDS THE SIZE OF AVAILABLE MAIN MEMORY = oc 


I gi be INFORMATION SHOULD BE BIRECTiY (AND CONTINUOUSLY 
ACCESSIBLE BY THE USER COMMUNITY 


IN MEMORY SHOULD ONLY AFFECT PROCESSING TIME, NOT 
PABILITY 
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) MAIN MEMORY MANAGEMENT SHOULD BE A TASK FOR THE 
SYSTEM, NOT THE PROGRAMMER - 
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J ALL ON-LINE INFORMATION 15 PROCESSOR ADDRESSABLE 


f ALL INFORMATION (PROCEDURE AND DATA) iS COMPARTMENTALICED INTO 
UNITS CALLED "SEGMENTS" ALLOWING THE ASSOCIATION OF ATTRIBUTES 
WITH EACH SEGMENT(1) 


2S 20 SSGMENTS:” 2NCllDs 
2 CU SIMPLY A SPECIAL KIND 


ease ow 
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_f SEGMENTS ARE MADE PROCESS ADDRESSABLE AS THEY ARE REFERENCED 


ALL SEGMENTS ARE DIVIDED INTO AN INTEGRAL NUMBER OF 
_ PAGES. THESE PAGES ARE BROUGHT INTO MAIN MEMORY IF AND ONL 
~ THEY ARE REFERENCED (NEEDED)-AT THE TIME THEY ARE REF 
ANY PROCESS me 
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) THE MULTICS HARDWARE INTERPRETS ALL ADDRESSES AS OFFSETS WI 
A SPECIFIED SEGMENT (SEGNO|OFFSET) 


HARDWARE MAKES NO DISTINCTION BETWEEN PROCEDURE AND 


eee 


THE SAME MANNER 


SEGMENTS. BOTH ARE PAGED IN THE SAME MANNER, BSOTH ARE ADDRESSED 
IN a 
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J ALL COMPILERS PRODUCE LOAD MODULES - NO MODIFICATION IS REQUIRED 


TO EXECUTE PROCEDURE CODE 
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SELECTIVE, CONTROLLED SHARING 


&® MOTIVATION 


f| USERS SHOULD BE ABLE TO USE COMMON PROCEDURE AND DATA SEGMENTS 
DIRECTLY (NOT COPIES) 


“| USERS- SHOULD BE ABLE TO SHARE PRIVATE CODE IN A SELECTIVE MANNER 


8 IMPLEMENTATION 


-f PURE, REENTRANT CODE IS ALWAYS GENERATED B8Y- THE-COMPILERS 
: (ALLOWING SHARING OF PROCEDURE CODE iN A. MULTI-PROCESS 


ENVI RONMENT ) 
l. “SVERYUTRING THE USER. TOUCHES. (SEZSCCTE. “OR RESERENCE) “WEEe. SS a 
SEGMENT EAVING ITS OWN ATTRIBUTES 


| THE. ACCESS ATTRISUTES. OF ZACH: “SEGMENT ARS. ESTASLISHED Bi TRE 
OWNER OF THAT SEGMENT : 
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OTIVATION 


IN AN ENVIRONMENT OF SEVERAL COEXZISTING PROCESSES, USERS MUST BE 
PROTECTED FROM ACCIDENTALLY OR INTENTIONALLY INTERFERING WITH 
EACH OTHER ames 


THE SUPERVISOR MUST BE PROTECTED FROM DAMAGES BY USERS ~~ 


CHANGES IN ACCESS TO INFORMATION MUST BE IMMEDIATELY EFFECTIVE 


DISCLOSURE OF INFORMATION SHOULD BE ALLOWED IN A SELECTIVE AN 


CONTROLLED MANNER (VERSUS ALL-OR-NONE APPROACH) mw 


UNWARRANTED DENIAL OF ACCESS TO INFORMATION MUST BE PROHIBITED 


LEMENTATION 


PER-SEGMENT ACCESS CONTROL LIST (ACL) - SPECIFYING BY WHOM AND 
HOW TRE SEGMENT MAY BS ACCESSED 


RING PROTECTION MECHANISM - ISOLATES SEGMENTS AND PROCESSES 


ACCESS ISOLATION MECHANISM (AIM) - ISOLATES SEGMENTS ACCORDING 
TO CATEGORIES AND SECURITY LEVELS 


PASSWORDS AND AUDIT TRAILS 
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SECURITY 


Jones.ProjA.a 
Top Secret/NATO 
Ring 4 


ee ee 


RING EES, (Yes) 


2 
= 
AT + REFAD 
2 
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aif 


rw *.ProjA. * 
Secret/Air Force 
Rirg Brackets 1,7,7 
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OPEN-ENDED, MODULAR SYSTEM 


MOTIVATION 


c= 


SOFTWARE SHOULD BE EAST TO MODIFY AND E&STEND 


Ot 
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TING SYSTEM SHOULD BE MODULAR, AND THE MODULES SHOULD 
REXENSIBLE Te _. 


- om oese 


MODULAR DESIGN OF OPERATING SYSTEM AND USER PROGRAMS (COMPILERS, 
PROGRAMMING ENVIRONMENT ENCOURAGE MODULAR DESIGN) , ia 


UNIFORM PROGRAMMING CONVENTIONS ARE FOLLOWED THROUGHOUT MOST 
S25 0S" Coos 


MORE . THAN $2% OF THE OPERATING SYSTEM OBJECT CODE ORIGINATED 


‘FROM PL/I SOURCE 


S RE-COMPILING, RE-EDITING WHEN 
) 


ON-LINE MODIFICATION, TESTING AND INSTALLATION OF SYSTEM MODULES 


(NUot2CS INSTALLATION FACILITY = MIS) 


-i.B3RARY MANAGEMENT TOOLS AND LIBRARY CONVENTIONS 
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DECENTRALIZED ADMINISTRATION 


@ MOTIVATION 
| SYSTEM RESOURCES MUST BE EFFECTIVELY ADMINISTERED 


--- {| RESOURCE ALLOCATION, ACCOUNTING, REGISTRATION, BILLING, ETC; 
TOO MUCH FOR SINGLE INDIVIDUAL ; 


ie 
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J OLFFERENT GROUPS OF USERS HAVE DIFFERENT ADMINIST 


f GROUPING OF USERS, BY FUNCTION OR MANAGEMENT, INTO PROCCECTS 


f THREES-LEVEL HIERARCHY OF ADMINISTRATION 


§ SYSTEM ADMINISTRATOR: DISTRIBUTES ‘RESOURCES AND: ASSIENS 
ATTRIBUTES TO PROJECTS 


) PROGECT ADMINISTRATORS: DISTRIBUTES RESOURCES AND ASSIGNS 
ATTRISUTES TO USERS 


f USERS: HAS FULL CONTROL OVER ALLOCATED RESOURCES, MCDIFITC: 
BY ASSIGNED ATTRISUTE 


J THE PROJECT ADMINISTRATOR MAY PASS DOWNWARD ONLY THOSE RESCURCES 
AND ATTRIBUTES THAT HAVE SEEN GIVEN TO THE PROJECT 
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TRALIZED ADMINISTRATION 


ATTRIBUTES 


ASSIGNED 
TO 
PROJECT ABC 


ATTRIBUTES 
ASSIGNED 

TO 
PROJECT DEF 


SYSTEM ADMINISTRATION TABLE 
(>se1 >sat) 


CREATED AND MAINTAINED 
BY SYSTEM ADMINISTRATOR 


PROCESS ATTRIBUTES 


INTERSECTION 
OF ATTRIBUTES 
(COMPUTED AT 
LOGIN TIME) 
GIVEN TO May’s 


PROCESS 


ADDITIONAL DATA 
ABOUT May’s 
PROCESS 


PROCESS INITIALIZATION TABLE 
([pd] > pit) 

ANSWERING SERVICE 

TABLE ENTRY 


(ANSWER_TASLE, 
ABSENTEE_USER_TABLE, 
DAEMON _USER_TABLE) 


CREATED AT LOGIN 
DESTROYED AT LOGOUT 
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USER May 


ATTRIBUTES 
ASSIGNED 
TO 

USER Jones 


PROJECT DEFINITION TABLE 
(>SCi>pdt>ABC. pdt} 


CREATED AND MAINTAINED 
BY PROJECT ADMINISTRATOR 
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@ MOTIVATION 


THE .. STANDARD USER ENVIRONMENT SHOULD BE EXTENSIVELY 
USER-MODIFIABLE 


] THE CAPABILITY SHOULD EXIST TO DEVELOP AND IMPOSE CLOSED 
SUBSYSTEMS WHICH CAN PROVIDE ANY DESIRED ENVIRONMENT ~ 


- | USER HAS ABILITY TO CHANGE OR REPLACE CONTROL PROGRAMS IN THE 
USER'S RING é 


Jf PROJECT ADMINISTRATOR CAN IMPOSE A CLOSED SUBSYSTEM ENVIRONMENT 
OR A DIFFERENT process overseer ON USERS 
| «start..up.ec, ABBRE PROCESSOR, general ready, reacy off, °° 


add_search_rules, CONDITION HANDLING, ETC. 


f OTHER TOOLS PROVIDE SIMULATION, ENCAPSULATION CAPASILITY 
(enter_lss, project_start_up_) ; 


f STANDARD INTERFACE FOR INTERACTIVE SUBSYSTEMS (ssu_) ENCOURAGES 
UNIFORM, FAMILIAR BEHAVIOUR OF USER SUBSYSTEMS. 
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CONTINUOUS OPERATION 


ft OTL id PY CONCEPT: SYSTEM SHOULD BE AVAILABLE ON DEMAND AT ALL 
TIMES 


) ON-LINE SOFTW 


4 


NVARE INSTALLATION 


=<[e ON-LINE MAINTENANCE: MOVE MORE AND MORE BOS Chener eres EB re ©. 
MULTICS (2G: RE-BOCT FNP FROM MULTICS) i 


f ON-LINE ACCOUNTING AND BILLING 

J DYNAMIC RECONFIGURATION 

f DYNAMIC FAILSOFT DECONFIGURATION OF FAILING HARDWARE 
f UNATTENDED SERVICE 


] AUTOMATIC REBOOT 


a 
0) 
t 
3 
oO 
wW 
wb 
w 
aw 
'd 
4 
oO 
a. 
Cc 
ie) 
m 
ior 
[ 
' 
ed 
Nw 
hy 
mM 
© 
oe 


MOTIVATION 
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AUST PROVIDE USERS SOME ASSURANCE THAT THEIR ON-LINE INFORMATION 
iS SAFE 


‘MUST PROVIDE CHECKPOINT CAPABILITY FOR RECOVERY FROM USER ERROR 
OR SYSTEM DISASTER : i 


IMPLEMENTATION 


AUTOMATIC BACKUP/RETRIEVAL FACILITY 

CONSOLIDATED STORAGE SYSTEM BUMPS 

PHYSICAL AND LOGICAL SAVE/RESTORE 

ALL STORAGE SYSTEM RECOVERY PROCEDURES RUN WHILE SYSTEM ie Ue 


DAMAGE RECOVERY RUN AUTOMATICALLY FOLLOWING SYSTEM FAILURE 
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| UTILITY CONCEPT: FULL ACCESS FROM ANY PHONE IN THE WORLD VIA 
ANY REMOTE DEVICE “a ; 


[ WISH TO PROVIDE ONE "COMMAND LANGUAGE", TO SERVE ALL USERS, 
WHETHER LOCAL OR REMOTE, INTERACTIVE OR BATCH 


~MPLEMENTATION 

i TULTICS COMMUNICATION SYSTEM (MCS) 

f IN PRINCIPLE, ANY REMOTE DEVICE/TERMINAL IS CONNECTASLE © 
f SINGLE COMMAND LANGUAGE 

f REMOTE JOB ENTRY (RCE) AND BULK 2/0 CAPABILITIES 


f DIRECT ATTACHMENTS TO PUBLIC DATA NETWORKS VIA &.25 
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SFFICIENT SERVICE TO LARGE OR SMALL USERS 


MOTIVATION 
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UTILITY CONCEPT: SYSTEM SHOULD BE AVAILABLE FOR,-AND CAPASLE 
OF, ANY SIZE TASK ee 


RUNNING BOTH LARGE AND SMALL TASKS TOGETHER SHOULD NOT IMPACT. 


THE EFFICIENCY OF EITHER - - 


DYNAMIC RESOURCE ALLOCATION (DON'T HAVE TO. PRE-ALLOCATE: OR 
GUESS-TIMATE RESOURCES REQUIRED) — p oe 


DYNAMIC SYSTEM TUNING TO ACCOMMODATE CHANGING SYSTEM WORKLOADS. 


STRUCTURE OF THE OPERATING SYSTEM 


| SUBROUTINES (550) 


DESCRIBED IN THE MPM MANUALS "Multics Subroutines" (AG93) AND 
"Subsystems Writer's Guide” (OFTEN ABBREVIATED AS "SWG") 
(AKS2} 


1 TOOLS (220) 


| DESCRIBED 


IN THE MPM MANUAL "“Multics Commands and Active 
Functions” (AG92) 


[ ADMINISTRATIVE ROUTINES (200) 


f DESCRIBED IN THE MAM MANUALS "System Administrator" (AK50),— 
"Registration 4& 


& Accounting Administrator" (AS68), "Project 
Administrator” (AK51). . 


| OPERATOR COMMANDS (150) 


f DESCRIBED IN THE MANUAL "Operator's Handbook" (AM81i1) 
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WHAT IS THE MULTICS SUPERVISOR 


® WHAT IS THE MULTICS SUPERVISOR? 


f A COLLECTION OF MANY LOGICAL SUBSYSTEMS WHICH IMPLEMENT THE 
FUNCTIONS OF MULTICS 


] THE PRIMARY PURPOSE OF MULTICS IS TO RUN PROGRAMS, WHICH ACCESS 
DATA, AND THUS THE MAJOR PURPOSE OF THE MULTICS SUPERVISOR £5. 7o 
MAKE THAT DATA ACCESSIBLE 


| THESE SUBSYSTEMS FALL INTO FOUR MAJOR GROUPS: 
| THE FILE SYSTEM 
| SUPPORT SERVICES FOR THE FILE SYSTEM 
| MISCELLANEOUS SUPERVISOR SERVICES 


] SUBSYSTEMS RELATED TO, BUT NOT STRICTLY PART. “OF -TEe 
SUPERVISOR 


] THESE DIVISIONS ARE SOMEWHAT ARTIFICIAL, BECAUSE THE SUBSYSTEMS 
ARE ALL INTIMATELY RELATED TO EACH OTHER. THE DIVISIONS 
REPRESENT A PARTICULAR VIEWPOINT OF SYSTEM FUNCTION. 


1 A MULTICS SUBSYSTEM IS A SET OF PROGRAMS PERFORMING A SPECIFI 
SERVICE FOR THE USER COMMUNITY - AND FOR THE OPERATING SYSTEM 
LTSELE 


| ‘TOGETHER, ALL THESE SUBSYSTEMS IMPLEMENT THE FUNCTIONS DESCRIBED 
IN THE MPM SUBROUTINES AND SWG MANUALS, (ESSENTIALLY hes_ AND 
THE VIRTUALS MEMORY). 
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THE MAJOR SUPERVISOR SUBSYSTEMS 


© j\MAJOR MULTICS SUPERVISOR SUBSYSTEMS: FOUR GROUPS OF ABOUT-.FOUR 
SUBSYSTEMS EACH 


f ——1 J 


THE FILE SYSTEM - THOSE SUBSYSTEMS WHICH ARE CONCERNED WI 
STORING DATA, MANAGING DATA, AND MAKING IT AVAILABLE TO USER 
FIVE MAJOR COMPONENTS: | 


l NAME SPACE / ADDRESS SPACE CONTROL 
1 DIRECTORY CONTROL 

d sabe MANAGEMENT 

[ . SEGMENT CONTROL 


l PAGE CONTROL 


f SERVICES TO SUPPORT THE FILE SYSTEM, WHICH MULTIPLEX ITS 
FACILITIES BETWEEN DIFFERENT USERS, AND ENSURE ITS RELIABILITY. 
FOUR MAJOR COMPONENTS: 


J TRAFFIC CONTROL . 
f FAULT AND INTERRUPT HANDLING 


f SYSTEM INITIALIZATION 


) THE FILE SYSTEM SALVAGERS 
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THE MAJOR SUPERVISOR SUBSYSTEMS 


) MISCELLANEOUS SUPERVISOR SERVICES - THESE ARE THINGS DONE IN THE 
SUPERVISOR FOR REASONS OF ACCESS CONTROL AND SHARING, BUT NOT 
DIRECTLY RELATED TO THE FILE SYSTEM 


J BECAUSE THEY ARE NOT DIRECTLY RELATED, THEY WILL NOT BE COVERED 
IN ANY DETAIL 


| MULTICS COMMUNICATIONS SYSTEM 
| RESOURCE CONTROL 

J USER DEVICE 1/0 = ioi_ 

] LOW LEVEL SUPERVISOR 1/0 

] RECONFIGURATION 


J SYSTEM ERROR HANDLING (syserr / verify _lock) 


1 RELATED SUBSYSTEMS - THESE ARE NOT ACTUALLY PART OF THE 
SUPERVISOR, BUT ARE CLOSELY RELATED ee 


f METERING AND TUNING 


f THE Initializer.SysDaemon 


® THE MULTICS SUPERVISOR IS DESIGNED AROUND THE _ "LAYERED MACHINE" 
CONCEPT 
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THE MAJOR SUPERVISOR SUBSYSTEMS 


CONSTRUCT A SIMPLE SET OF OPERATIONS CALLED A “KERNEL” WHICH 
IMPLEMENTS THE MOST FUNDAMENTAL (PRIMITIVE) OPERATIONS REQUIRED 


CONSTRUCT A SLIGHTLY MORE SOPHISTICATED SET OF OPERATIONS WHICH 
ASSUMES AND RELIES ON THE CORRECT FUNCTIONING OF THE KERNEL - 
ANOTHER "LAYER" 


CONSTRUCT A MORE SOPHISTICATED LAYER WHICH ASSUMES AND RELIES ON 
THE CORRECT FUNCTIONING OF THE PREVIOUS MACHINES 


ETC 


® THE "LAYERS" OF THE MULTICS SUPERVISOR PARTIALLY MAP INTO THE ABOVE 
SUBSYSTEMS 


® THE 


Not To 
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FOLLOWING DIAGRAM REPRESENTS THIS MAPPING: 
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Not To 


THE MAJOR SUPERVISOR SUBSYSTEMS 


NAME SPACE/ADDRESS SPACE 
MANAGEMENT 


TRAFFIC 
CONTROL 


PAGE CONTROL 


‘DIRECTORY CONTROL 


THE MULTICS SUPERVISOR 


' COMPONENTS ARE ASYNCHRONOUSLY INVOKED 
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NAME SPACE /ADDRESS SPACE MANAGEMENT 


IMPLEMENT THE PER PROCESS VIRTUAL MEMORY 


BASIC PHILOSOPHY _ 


AS A NEWLY LOGGED IN USER ATTEMPTS TO TOUCH VARIOUS SEGMENTS A 
CONSIDERABLE AMOUNT OF MANAGEMENT INFORMATION MUST BE 
( TRANSPARENTLY ) FOUND AND/OR COMPUTED BEFORE THE USER'S 
REFERENCE IS ACTUALLY ACCOMPLISHED 


FOR EVERY SEGMENT REFERENCED 3Y THE USER, THE SUPERVISOR: 


] ASSIGNS A SEGMENT NUMBER (FOR REASON OF HARDWARE aa arate 


AKTITS 
FLiN ad 


J RECORDS (REMEMBERS ) THE MANAGEMENT INFORMATION (FOR BEES OF 
SOUS EFFICIENCY .AND ON) 


SUCH SEGMENTS ARE SAID TO BE "KNOWN TO THE PROCESS" 


THE MANAGEMENT INFORMATION IS MAINTAINED ON A PER PROCESS BASIS 
IN THREE COMPLEMENTING AREAS: DSEG, KST, AND RNT 
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NAME SPACE/ADDRESS SPACE MANAGEMENT 


[| MANAGES TWO DISTINCT SETS OF INFORMATION: 


1 ADDRESS SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND 
THE SEGMENTS THEMSELVES 


1 NAME SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND NAMES 
THE USER REFERS TO THEM BY 


J CALLS DIRECTORY CONTROL TO LOCATE SEGMENTS INITIALLY 


§ NAME SPACE / ADDRESS SPACE MANAGEMENT IS INVOKED BY SUBROUTINE 
CALLS, AND BY LINKAGE FAULTS (THE "DYNAMIC LINKER") 


® PRINCIPAL USER INTERFACES 


| COMMAND LEVEL 


J initiate, terminate, terminate _segno, terminate _ref_name, 
terminate_single ref name, list_ref_name 


] THE COMMAND PROCESSOR ITSELF - WHICH USES THESE SERVICES TO 
LOCATE COMMANDS 


{ SUBROUTINE LEVEL 


J hes_Sinitiate, hes_Sinitiate_count_, hes_S$terminate file, 
hes_Sterminate_seg, hcs_S$terminate name, 
hes S$terminate_noname, term_ 
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NAME SPACE/ADDRESS SPACE MANAGEMENT 


MAJOR DATA BASES 


] DESCRIPTOR SEGMENT (DSEG) - ONE PER PROCESS 


SEGMENT DESCRIPTOR WORD (SDW) - ONE PER KNOWN SEGMENT 


DEFINES THE USER'S ADDRESS SPACE TO THE HARDWARE 


f KNOWN SEGMENT TABLE (KST) - ONE PER PROCESS | 


L mm ] 


KNOWN SEGMENT TABLE ENTRY (KSTE) - ONE PER KNOWN SEGMENT 
(EXCEPT SUPERVISOR SEGMENTS ) 


DEFINES THE USER'S ADDRESS SPACE TO THE SUPERVISOR AND THE 


A USER'S SEGMENT NUMBER WITH THE SEGMENT 


ded NSS oetcnd 


e 
OF THAT SEGMENT 


THE SEARCH FOR AN AVAILABLE KSTE DETERMINES A SEGMENT'S 
NUMBER 


f REFERENCE NAME TABLE (RNT) - ONE PER EACH RING IN EACH PROCESS 


! 


NOT A SEGMENT - KEPT AS A REGION ALLOCATED IN THE "LINKAGE 
AREA" FOR EACH RING | an ; 


REFERENCE NAME TABLE ENTRY (RNTB) - ONE PER REFERENCE NAME 


USED BY THE DYNAMIC LINKER = TO IMPLEMENT By 
"initiated_segments" SEARCH RULE 
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NAME SPACE/ADDRESS SPACE MANAGEMENT 


DEFINES THE USER'S NAME SPACE TO THE USER 


NAME SPACE MAY BE DIFFERENT IN DIFFERENT RINGS OF 
PROCESS 
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DIRECTORY CONTROL 


FUNCTION 


DIRECTORY CONTROL IS 
mr T 


THE MAINTENANCE OF 17 
HIERARCHY 


A SET OF HARDCORE MODULES RESPONSIBLE FOR 
E MULTICS DIRECTORY STRUCTURE -~- IE: THE 


ITS TASKS INCLUDE CREATING, MANIPULATING AND INTERPRETING THE 
CONTENTS OF DIRECTORY SEGMENTS, TO INCLUDE: 


J ACCESS CONTROL LISTS (ACL'S), NAMES, AND VTOCE POINTERS OF 
ENTRIES DESCRIBED THEREIN , 


ONLY DIRECTORY CONTROL IS ALLOWED TO ALTER “THE CONTENTS OF 
DIRECTORY SEGMENTS 


DIRECTORY CONTROL IMPLICITLY RELIES UPON THE SERVICES OF OTHER 
SUBSYSTEMS SUCH AS SEGMENT CONTROL AND PAGE CONTROL, AND ALSO 


wd out ed & wet o otw om 


INVOKES © THEM PERES TE? BY SUBROUTINE CALL 


J DIRECTORIES ARE SIMPLY SEGMENTS TO THESE SUBSYSTEMS 


DIRECTORY CONTROL IS. INVOKED ONLY BY SUBROUTINE CALLS 


PRINCIPAL USER INTERFACES 


COMMAND LEVEL 7 : 2s 
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DIRECTORY CONTROL 


J create, create dir, link, set_acl, delete_acl, status, list, 
add_name, rename 


f SUBROUTINE LEVEL 


J hces_Sappend_branch, hcs_Sadd_acl_entries, hces_sappend_link, 
hes_S$delete_acl_entries, hcs_sstatus_, hcs_schname_file 


® MAJOR DATA BASES 


{| DIRECTORY SEGMENTS 


f CONTAIN THE ATTRIBUTES AND OTHER INFORMATION ABOUT THEIR 
SEGMENTS (NEEDED TO FIND SEGMENTS, RETURN STATUS INFORMATION, 
AND BUILD VTOCE'S AT SEGMENT CREATION) 


l THE DIRLOCKT_SEG 


| SEGMENT WHERE DIRECTORY LOCKING IS MANAGED 
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VOLUME MANAGEMENT 


® FUNCTION 


| VOLUME MANAGEMENT IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 


AND LOGICAL VOLUMES 


| ITS TASKS INCLUDE: 
] ACCEPTANCE AND DEMOUNTING OF PHYSICAL VOLUMES 


f MAINTAINING THE ASSOCIATION BETWEEN PHYSICAL VOLUMES, LOGICAL 
VOLUMES, AND DISK DRIVES 


f ENSURING THE INTEGRITY OF VOLUME CONTENTS 


J MAKING VOLUME CONTENTS ACCESSABLE TO PAGE CONTROL (PAGES) AND 
SEGMENT CONTROL (VTOC ENTRIES) 


) VOLUME MANAGEMENT IS INVOKED ONLY BY SUBROUTINE CALLS 


= 


Not To Be Reproduced 2714 FBOA 


VOLUME MANAGEMENT 


® MAJOR DATA BASES 


J PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM 


J PHYSICAL VOLUME TABLE ENTRY oven - ONE PER DISK DRIVE KNOWN 
TO THE SYSTEM 


] EACH PVTE IDENTIFIES A DRIVE'S DEVICE NUMBER, SUBSYSTEM NAME, 
DEVICE TYPE, AND INFORMATION ABOUT THE PHYSICAL VOLUME 
CURRENTLY MOUNTED 


‘ USED TO MAP REFERENCES TO PAGES OF SEGMENTS INTO” AN 1/0 
' REQUEST TO THE CORRECT DISK DRIVE ete ee 


| LOGICAL VOLUME TABLE (LVT) - ONE PER SYSTEM 


J LOGICAL VOLUME TABLE ENTRY (LVTE) - ONE PER MOUNTED LOGICAL 
VOLUME 

| BACH LVTE CONTAINS THE LOGICAL YOLUME ID, POINTERS TO MEMBER 
PVTE'S, AIM CLASS LIMITS, ETC. 


J USED TO DETERMINE A USER'S ACCESS TO A LOGICAL VOLUME 
(PRIVATE OR PUBLIC) AND TO LOCATE MEMBER PHYSICAL VOLUMES 


J. VOLUME HEADER - ONE PER PACK 
[| VOLUME LABEL (REGISTRATION AND ACCEPTANCE INFORMATION) 


{ VOLUME MAP (OCCUPIED/VACANT INFORMATION FOR VOLUME CONTENTS ) 
| Vyole S&S 
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VOLUME MANAGEMENT 


f RECORD STOCKS - ONE PER MOUNTED VOLUME 


) ONLINE CACHE OF INFORMATION ABOUT USED / UNUSED RECORDS ON 
THE VOLUME . 


] THIS INFORMATION IS DERIVED FROM THE VOLUME MAP, BUT KEPT 
ONLINE TO AVOID THE NECESSITY OF REFERRING TO THE VOLUME MAP 
ON DISK EVERY TIME A RECORD Is ALLOCATED OR FREED 


] WHEN THE CACHE BECOMES COMPLETELY EMPTY OR COMPLETELY FULL, 
IT MUST BE UPDATED FROM/TO DISK - A PROTOCOL ENSURES THAT THE 
COPY ON DISK IS ALWAYS CONSISTENT — 


J PROVIDED BY VOLUME MANAGEMENT, BUT USED BY PAGE CONTROL 


| VTOCE STOCKS - ONE PER VOLUME 


. SIMILAR TO RECORD STOCKS, BUT MAINTAINS INFORMATION ABOUT 


VT 
OC ENTRIES ON THE VOLUME 


[= J 


PROVIDED BY VOLUME MANAGEMENT, BUT USED BY SEGMENT CONTROL 


| PHYSICAL VOLUME HOLD TABLE (PVHT) - ONE PER SYSTEM 


[ RECORDS THE COMMENCEMENT OF COMPOUND 1/O OPERATIONS UPON A 
PHYSICAL VOLUME | 


{ THIS INFORMATION PREVENTS A VOLUME FROM BEING DEMOUNTED WHILE 
SUCH AN OPERATION IS IN PROGRESS 
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SEGMENT CONTROL 


@ FUNCTION 


] SEGMENT CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF LOGICAL 
MEMORY 


] ITS TASKS INCLUDE: 


] MAINTAINING THE DISK RESIDENT MAPS OF SEGMENTS (IE: THEIR 
VTOCE'S) 


{ SEGMENT CREATION, TRUNCATION AND DELETION 


] SEGMENT ACTIVATION AND DEACTIVATION (ASTE MULTI PLEXING) 


| SEGMENT CONTROL CAN BE INVOKED EITHER BY SUBROUTINE CALLS OR BY 
SEGMENT FAULTS 


® BASIC PHILOSOPHY OF ACTIVATION/DEACTIVATION 


papelne) pap Gite se 


VOLUMES, ONLY A SMALL SUBSET WILL REQUIRE ACCESSING AT ANY ONE 
TIME. SUCH SEGMENTS WILL BE CALLED "ACTIVE SEGMENTS” 


1. OF ALL SEGMENTS RESIDENT WITHIN THE SYSTEM'S MOUNTED PHYSICAL 


f A PART OF MAIN MEMORY, CALLED THE "ACTIVE SEGMENT TABLE" (AST), 
WILL BE RESERVED TO HOLD MANAGEMENT INFORMATION FOR THESE ACTIVE 
SEGMENTS (IDENTITY, PVT INDEX, LOCATION OF PAGES, aTC. ) 
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SEGMENT CONTROL 


f AS SEGMENTS FALL INTO DISUSE, THEIR “MANAGEMENT INFORMATION" IN 
THE AST WILL BE REPLACED WITH INFORMATION OF OTHER SEGMENTS 
REQUIRING ACTIVATION 


® USER INTERFACE 


| COMMAND LEVEL 


1 create, delete, truncate, etc. 


) SUBROUTINE LEVEL 


J hes _Sappend_branch, hes_Sappend_branchx, hes_$delentry_seg, 
hes_Sdelentry_file, hes_Struncate_seg, hes_Struncate_ file, 
hes _Sforce_ write, etc 


® MAJOR DATA BASES 


SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM, SHARED WITH PAGE 


2 


CONTROL. ONE MAJOR COMPONENT IS "OWNED" BY SEGMENT CONTROL: 
| ACTIVE SEGMENT TABLE (AST) - ONE PER SYSTEM 
[| THE AST IS A LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 
| ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER race SEGMENT 
| ASTES CONTAIN PHYSICAL VOLUME ID'S (PVID'S) AND VTOC 


INDEX'S (VTOCZ'S) OF SEGMENTS. NEEDED BY SEGMENT CONTROL 
TO FIND THE SEGMENT ON DISK (HARDWARS) 
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SEGMENT CONTROL 


{ AST HASH TABLE 
] ALLOWS EFFICIENT SEARCHING OF ASTE'S 


[ LOGICALLY PART OF THE AST, BUT ELSEWHERE FOR HISTORICAL 
REASONS 


| DIRECTORY SEGMENTS 


] CONTAIN LOCATIONS AND ATTRIBUTES OF SEGMENTS. LOCATION 
INFORMATION FROM DIRECTORY SEGMENTS IS PROVIDED TO SEGMENT 
‘ CONTROL BY DIRECTORY CONTROL . 


j VOLUME TABLE OF CONTENTS (VTOC) - ONE PER PHYSICAL VOLUME 


{ VOLUME TABLE OF CONTENTS ENTRY (VTOCE) - ONE PER 
DISK-RESIDENT SEGMENT 


] EACH VTOCE CONTAINS THE SEGMENT'S UNIQUE ID, CURRENT LENGTH, 
FILE MAP, ETC (NEED TO BUILD ASTE'S AND PT'S) 


] VTOCES ARE READ AND WRITTEN ONLY BY SEGMENT CONTROL 


] VTOCE STOCKS - FROM VOLUME MANAGEMENT 


[| USED WHEN CREATING AND DELETING VTOCES FOR SEGMENTS 
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PAGE CONTROL 


® FUNCTION 


eas 


PAGE CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 
MEMORY TO INCLUDE THE MULTIPLEXING OF MAIN MEMORY FRAMES, AND 
THE MANAGEMENT OF DISK STORAGE 


J ITS TASKS INCLUDE: 


J TRANSFERRING THE PAGES OF SEGMENTS BETWEEN THE MEMORY 
DEVICES, AND RECORDING THE LOCATION OF "THE" COPY OF THESE 
PAGES 


J REPORTING THE STATUS AND FILE MAPS OF SEGMENTS TO SEGMENT 


CONTROL 


J PAGE CONTROL IS LARGELY CODED IN MULTICS ASSEMBLER LANGUAGE 
(ALM) 


1 PAGE CONTROL CAN BE INVOKED EITHER BY SUBROUTINE CALLS OR BY 
PAGE FAULTS 


[ THERE ARE NO EXPLICIT USER INTERFACES TO PAGE CONTROL 
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PAGE CONTROL 


® BASIC PHILOSOPHY 


) OF ALL THE SEGMENTS ACTIVE AT A GIVEN TIME, ONLY A SMALL SUBSET 
OF THEIR TOTAL PAGES WILL BE REQUIRED FOR ACCESSING 


) PAGES WILL BE READ INTO MAIN MEMORY AS THEY ARE REQUIRED 


{| THE READING OF A PAGE INTO MAIN MEMORY WILL (PROBABLY) REQUIRE 
THE EVICTION OF A PREVIOUSLY REQUIRED PAGE 


| THE CHOICE OF A PAGE FOR EVICTION WILL BE BASED ESSENTIALLY UPON 
A “LEAST RECENTLY USED" CRITERIA . 


| AN EVICTED PAGE NEED BE WRITTEN BACK TO DISK ONLY IF iT WAS 
MODIFIED DURING ITS RESIDENCY IN MAIN MEMORY 


@® MAJOR DATA BASES 


J PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM. PROVIDED BY 
VOLUME MANAGEMENT 


| PHYSICAL VOLUME TABLE ENTRY (PVTE) - ONE PER DISK DRIVE 
CONFIGURED © | 


] EACH PVTE CONTAINS: 


] THE DEVICE ID (DISK DRIVE ID) AND THE ID OF THE PHYSICAL 
VOLUME (DISK PACK) CURRENTLY MOUNTED 
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PAGE CONTROL 


] THE NUMBER OF RECORDS LEFT UNALLOCATED ON THE PHYSICAL 
VOLUME, POINTER TO THE RECORD STOCK, ETC 


RECORD STOCKS - ONE PER MOUNTED PHYSICAL VOLUME, PROVIDED BY 
VOLUME MANAGEMENT 7 | 


| CONTAINS AN IN-MEMORY CACHE OF THE IN-USE STATUS OF RECORDS 
ON THE VOLUME, FROM THE VOLUME MAP, USED WHEN ALLOCATING OR 
FREEING PAGES | 


! ACCESSED BY A COMPLEX MECHANISM WHICH USES NORMAL PAGE 1/0 
BUT HAS A PROTOCOL TO ENSURE SYNCHRONIZATION OF DISK CONTENTS 
AND RECORD Tork CONTENTS 


| SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM. | SHARED WITH 


SEGMENT CONTROL. CONTAINS THE FOLLOWING FIVE DATA BASES USED BY 
PAGE CONTROL: | 
] SYSTEM SEGMENT TABLE (SST) HEADER - ONE PER SYSTEM 


z CONTAINS A LARGE NUMBER OF COUNTERS AND POINTERS VITAL TO 
THE MAINTENANCE AND METERING OF THE STORAGE SYSTEM 


J CONTAINS LOCKWORDS USED TO SYNCHRONIZE PAGE CONTROL AND 
SEGMENT CONTROL OPERATIONS 
J CORE MAP - THE core_map SEGMENT - ONE PER SYSTEM 


J CORE MAP ENTRY (CME) - ONE PER FRAME (1024 WORDS) OF 
CONFIGURED Bath MEMORY 


J EACH CME REPRESENTS A FRAME OF MAIN MEMORY AND IDENTIFIES 
THE CURRENT OCCUPANT OF THAT FRAME 


ca 
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PAGE CONTROL 


NOT PART OF THE SST SEGMENT ANY MORE, BUT LOGICALLY PART 
OF THE SST 


] ACTIVE SEGMENT TABLE (AST) - ONE PER SYSTEM 
] ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE. PER ACTIVE SEGMENT 


) LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 


) PAGE TABLES (PT) - ONE PER ACTIVE SEGMENT, THE OTHER HALF OF 


EACH ASTE 
f PAGE TABLE WORD (PAGE PTW) - EITHER 4, 16, 64, OR 256 PER 
PAGE TABLE 


J EACH PTW DEFINES THE CURRENT LOCATION OF A PAGE OF THE 
SEGMENT: DISK, MAIN MEMORY ADDRESS, OR NULL 


Not To Be Repreduced 2223 F8OA 


PAGE CONTROL 


THE MULTICS FILE SYSTEM 
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TRAFFIC CONTROL 


® FUNCTION 


. TRAFFIC CONTROL (OR THE "TRAFFIC CONTROLLER") IS RESPONSIBLE FOR 

' MANAGING THE ASSIGNMENT OF PHYSICAL PROCESSORS TO MULTICS 
PROCESSES AND IMPLEMENTING THE SYSTEM'S  WAIT/NOTIFY AND 
INTERPROCESS COMMUNICATION PRIMITIVES 


) THE FUNCTIONS ASSUMED BY THE TRAFFIC CONTROLLER ARE KNOWN AS 
MULTI PROGRAMMING, MULTIPROCESSING, SCHEDULING, DISPATCHING, 
PROCESSOR MANAGEMENT, AND INTERPROCESS COMMUNICATION. 


J ITS MAJOR FUNCTION IS ALLOWING PROCESSES TO AWAIT THE COMPLETION 
OF FILE SYSTEM OPERATIONS, SUCH AS PAGE 1/0 


f TRAFFIC CONTROL CAN BE INVOKED BY SUBROUTINE CALLS AND 
INTERRUPTS 


] THERE ARE NO IMPORTANT USER SUBROUTINE INTERFACES, BUT THERE ARE 
PRIVILEGED SUBROUTINE INTERFACES FOR PROCESS CREATION, 
ADJUSTMENT OF SCHEDULING PARAMETERS, ETC. 


@ MAJOR DATA BASES 


] TC_DATA SEGMENT - ONE PER SYSTEM. CONTAINS THE FOLLOWING FOUR 
DATA BASES: 


) TC_DATA HEADER - ONE PER SYSTEM 


f CONTAINS VARIOUS METERS, COUNTERS AND POINTERS USED BY THE 
TRAFFIC CONTROLLER 
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TRAFFIC CONTROL 


] ACTIVE PROCESS TABLE (APT) - ONE PER SYSTEM 


1 ACTIVE PROCESS TABLE ENTRY (APTE) - ONE OCCUPIED PER 
ACTIVE PROCESS (TOTAL NUMBER IS DETERMINED BY CONFIG DECK) 


{| EACH APTE CONTAINS VARIOUS ATTRIBUTES OF AN ACTIVE PROCESS 
INCLUDING THE PROCESS ID, STATE, THE VALUE OF ITS 
DESCRIPTOR BASE REGISTER (DBR), SCHEDULING PARAMETERS, AND 
A POINTER TO THE PROCESS'S ITT ENTRIES 

| THE APTE CONTAINS ALL INFORMATION THE SUPERVISOR NEEDS TO 
KNOW ABOUT A PROCESS WHEN THE PROCESS IS NOT RUNNING 

[ INTERPROCESS TRANSMISSION TABLE (ITT) - ONE PER SYSTEM 

) ITT ENTRY - ONE OCCUPIED PER OUTSTANDING IPC WAKEUP 

[1 A QUEUE FOR TEMPORARILY STORING IPC WAKEUP INFORMATION 
(CHANNEL NAME, RANDOM DATA, PROCESS ID, ETC) 

{| WORK CLASS TABLE (WCT) - ONE PER SYSTEM 
) WORK CLASS TABLE ENTRY (WCTE) - ONE PER WORKCLASS 


) EACH WCTE CONTAINS ADMINISTRATOR DEFINED PARAMETERS OF THE 
WORKCLASS, VARIOUS METERS AND POINTERS 
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FAULT AND INTERRUPT HANDLING 


8 FUNCTION 


f RESPONSIBLE FOR HANDLING ALL EXCEPTIONS IN A CPU WHETHER 
INTERNAL TO THE PROCESSOR (REFERRED TO AS PAULTS ) OR EXTERNAL 
(REFERRED TO AS INTERRUPTS) 


] ESTABLISHES THE SUPERVISOR ENVIRONMENT AT FAULT AND INTERRUPT 
TIME. SAVES THE MACHINE CONDITIONS AND TRANSFERS TO THE 
APPROPRIATE HANDLER 


] MAJOR COMPONENTS: THE FAULT INTERCEPT MODULE (fim), WIRED-FAULT 
INTERCEPT MODULE (wired fim), 1/0 INTERRUPT HANDLER 
(io_interrupt), sys_trouble, page _fault 


® MAJOR DATA BASES 


f INTERRUPT VECTORS - ONE SET PER SYSTEM 


(WIRED) 


t 


) INTERRUPT PAIR (2 INSTRUCTIONS) - ONE PAIR - PER DEFINED 
INTERRUPT TYPE 


| LOCATED AT ABSOLUTE ADDRESS 0. A HARDWARE RECOGNIZED DATA 
BASE 


1 DESCRIBE WHERE TO SAVE THE CONTEXT, AND WHERE TO TRANSFER TO 
TO PROCESS THE INTERRUPT (ALWAYS io_interrupt) 
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FAULT AND INTERRUPT HANDLING 


J. FAULT VECTORS - ONE SET PER SYSTEM (WIRED) 


f VECTOR PAIR (2 INSTRUCTIONS) - ONE PAIR PER DEFINED FAULT 
TYPE 


. LOCATED AT ABSOLUTE ADDRESS 100 (OCTAL) IMMEDIATELY ABOVE THE 
INTERRUPT VECTORS. A HARDWARE RECOGNIZED DATA BASE 


f DESCRIBE WHERE TO SAVE THE CONTERZT, AND WHERE TO TRANSFER TO 
TO PROCESS THE FAULT (fim, wired_fim, page fault) 


J. PROCESS DATA SEGMENT (PDS) - ONE PER PROCESS (WIRED WHEN. 
ELIGIBLE) 


f CONTAINS PROCESS RELEVANT INFO SUCH AS PROCESS iD, USER ID, 
HOME /WORKING/PROCESS DIRECTORIES, AIM CLASSIFICATION, INITIAL 


RING, ETC 
f CONTAINS ALL INFORMATION ABOUT THE PROCESS NEEDED BY THE 
SUPERVISOR CODE WHEN THE PROCESS IS RUNNING 


f CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH CAN RESULT IN GIVING UP THE PROCESSOR: PAGE FAULTS, 
SEGMENT FAULTS, AND ALL FAULTS NOT HANDLED BY THE SUPERVISOR 


) PROCESSOR DATA SEGMENT (PRDS) - ONE PER CONFIGURED CPU (WIRED) 


{ SERVES AS RING-ZERO STACK FOR PAGE CONTROL AND TRAFFIC 
CONTROL 


J ALSO CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH USUALLY DO NOT MEAN GIVING UP THE PROCESSOR: CONNECT 
FAULTS AND INTERRUPTS. ; . 
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FAULT AND INTERRUPT HANDLING 


) FIM-TABLE Rasy oF For 
: WON & Feat VoB\e. 


J <A TABLE IN THE FIM PROGRAM WHICH DESCRIBES THE ACTION TO BE 
TAKEN FOR VARIOUS TYPES OF FAULTS 
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SYSTEM. INITIALIZATION SAMeOVISOC Link Snafhi ns 
Is STG ck nod DYhAnc. 
e', done alegd oF Time. 
@ FUNCTION Beg dows no dynonte Cn Ks.a9, 


PREPARE THE SYSTEM TO OPERATE, STARTING FROM A COMPLETELY EMPTY 
MACHINE ptr Ve 


SwaP \e' ot Vea v9: 


= 


dy e\\, oy 


f READS IN SUPERVISOR PROGRAMS FROM SYSTEM TAPE, SNAPS LINKS 
BETWEEN SUPERVISOR COMPONENTS, VERIFIES AND INITIALIZES HARDWARE 
CONFIGURATION, SETS UP SYSTEM DATABASES, ACCEPTS STORAGE SYSTEM 
DISKS AND PREPARES THEM FOR USE BY THE FILE SYSTEM : 


-]..MOST PROGRAMS IN SYSTEM INITIALIZATION ARE DELETED AFTER 
INITIALIZATION IS COMPLETE. only oxy section 15 KofT 


4 


] SUPERVISOR PROGRAMS ARE LOADED IN THREE "COLLECTIONS", EACE OF 
WHICH DEPENDS ON THE MECHANISMS SET UP BY THE PREVIOUS ONE 


® MAJOR DATA BASES 


[ THESE DATA BASES ARE ALL BUILT DURING THE PROCESS OF 
INITIALIZATION (EXCEPT FOR THE CONFIG DECK) AND KEPT AFTER 
INITIALIZATION IS FINISHED for © Bog, ne, 


i 
J SEGMENT LOADING TABLE (>sli>sit) 


) CONTAINS AN ENTRY DESCRIBING THE ATTRIBUTES OF EACH SEGMENT 
‘IN THE SUPERVISOR 


Not To Be Reproduced 2a50 F80A 


SYSTEM INITIALIZATION 


S ot Lebusouaty 
) NAME TABLE (>sli>name_table) 


nsaGers 
at Cron Aes 
f CONTAINS A LIST OF NAMES FOR EACH OF THE SEGMENTS IN THE 


SUPERVISOR 
\ zg ND goad enecter Cee<ot 
Lec hebouagyney G Ka _ 


] DEFINITIONS SEGMENT (>sli>definitions_) 


] CONTAINS THE DEFINITIONS SECTIONS FOR ALL THE -SEGMENTS IN THE 
SUPERVISOR, WHICH ARE USED IN ORDER TO SNAP LINKS BETWEEN THE 
SUPERVISOR MODULES 


CONFIG DECK (>sli>config_ deck) 


) CONTAINS A DESCRIPTION OF THE HARDWARE CONFIGURATION AND 
CERTAIN SOFTWARE PARAMETERS 


J PROVIDED TO SYSTEM INITIALIZATION BY BOS 


® SHUTDOWN -- TERMINATES THE ACTIVITIES OF THE SYSTEM IN AN ORDERLY 
FASHION 


| TWO TYPES OF SHUTDOWN: 


f NORMAL -- REQUESTED BY THE INITIALIZER, RUNS IN THE USUAL 
SUPERVISOR ENVIRONMENT 


‘| EMERGENCY -- USED AFTER A CRASH, MUST MAKE THE SUPERVISOR 
ENVIRONMENT OPERABLE BEFORE PROCEEDING 
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SYSTEM INITIALIZATION 


] BOTH TYPES EXIST PRIMARILY TO SHUT DOWN THE FILE SYSTEM -- THAT 
IS, TO WRITE ALL DATA IN MEMORY INTO ITS PROPER HOME ON DISK 


. INCLUDES PAGES OF SEGMENTS, VTOCES, VOLUME AND VTOC MAPS 


| SHUTDOWN ESSENTIALLY RUNS THE STEPS OF INITIALIZATION BACKWARDS, 
BUT WITH A LOT OF SHORTCUTS 
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FILE SYSTEM SALVAGERS 


® FUNCTION 


] ENSURE THE CONSISTENCY OF THE FILE SYSTEM DATABASES AND ea 
PERIODIC PREVENTIVE MAINTENANCE OPERATIONS 


| THERE ARE SEVERAL SALVAGERS, EACH WITH A DIFFERENT FUNCTION 


J BECAUSE OF THE COMPLICATED INTERACTIONS THEY HAVE WITH THE REST 
OF THE FILE SYSTEM, THE SALVAGERS ARE PERHAPS THE MOST 
COMPLICATED SINGLE PROGRAMS IN THE SUPERVISOR © 


f SOME SALVAGING IS DONE AUTOMATICALLY, WHEN THE SYSTEM DETECTS AN 
INCONSISTENCY. OTHER SALVAGE OPERATIONS ARE EAZPLICITLY 
REQUESTED, BY PRIVILEGED USERS. 


f EXCEPT FOR SUPERVISOR BUGS, THE ONLY TIME DAMAGE OCCURS THAT 
REQUIRES SALVAGING TO FIX IS AFTER A CRASH WHERE EMERGENCY 
SHUTDOWN FAILS 


® THE SALVAGERS: 


J DIRECTORY SALVAGER 


) CORRECTS INCONSISTENCIES IN DIRECTORY SEGMENTS BY REBUILDING 
THEM . 


(| THIS IS THE ONLY SALVAGER INVOKED AUTOMATICALLY IN USER 
PROCESSES: ANY ATTEMPT TO LEAVE RING ZERU WITH A DIRECTORY 
LOCKED FOR WRITING WILL CAUSE IT TO BE SALVAGED 
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FILE SYSTEM SALVAGERS 


J DIRECTORY SALVAGING ALSO RECLAIMS © WASTED SPACE IN THE 
DIRECTORY, AND IS RUN PERIODICALLY TO COMPACT DIRECTORIES 


] QUOTA SALVAGER 


J CORRECTS INCONSISTENCIES IN THE QUOTA SYSTEM 


| PHYSICAL VOLUME SCAVENGER Fixed Volume Mae | Vroce MAP 


BT ATAS vP te Cond ¢ thar Ked 2S bead Sed. 


f RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION FROM THE 
VTOCES ON A VOLUME, THEREBY RECLAIMING ANY RECORDS OR VTOCES 
WHICH MIGHT HAVE BEEN LOST | 


. RUNS ENTIRELY ONLINE WHILE THE SYSTEM IS UP FOR USERS (NEW IN 
MR10.1) 


] THIS TYPE OF DAMAGE IS ‘USUALLY BENIGN, SO RUNNING THE 
SCAVENGER CAN BE DELAYED. 


) PHYSICAL VOLUME SALVAGER 
I RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION 


f RUNS ONLY DURING INITIALIZATION, AND THEREFORE DELAYS CRASH 
RECOVERY 


J NOW USED ONLY. FOR RARE CASES WHERE THERE IS NOT ENOUGH FREE 
SPACE LEFT FOR THE SCAVENGER TO RUN. IN THESE RARE CASES, IT 
IS INVOKED AUTOMATICALLY BY SYSTEM INITIALIZATION. 


WEEP_PV | | 
fi 3s im Foxes, “(everce Connery Cy. 
me . t a 
Fixes tsa , n fore. 
~ r 
" aoe) C4vu Of, xs > C4 
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FILE SYSTEM SALVAGERS 


J DELETES UNUSED VTOC ENTRIES WHICH HAVE NO DIRECTORY ENTRY 
POINTING TO THEM 


) RUNS ENTIRELY IN USER RING, EXCEPT FOR ACTUALLY READING VTOC 
ENTRIES AND DIRECTORY ENTRIES 


] PURELY A HOUSEKEEPING FUNCTION, AND RUN ONLY RARELY. 


Not To Be Reproduced. 2 


us 

an 
Le § | 

(66) 
o> 
> 


METERING & TUNING 


® WHILE NOT A SUBSYSTEM ITSELF, METERING AND TUNING IS A POLICY AND 
CAPABILITY COMMON TO ALL OF THE SUPERVISOR'S SUBSYSTEMS 


& FUNCTION 


J. METERING (CONSISTS OF THREE ACTIVITIES) 
] "ACCUMULATING DATA: THIS .1I1S PERFORMED THROUGHOUT THE 
SUPERVISOR BY CODE WHICH . 


q RECORDS THE NUMBER OF TIMES AN EVENT HAPPENS OR A 
PARTICULAR PIECE OF CODE IS EXECUTED; AND/OR 


| RECORDS THE TIME REQUIRED TO PERFORM A TASK | 
J SUCH DATA IS STORED IN AREAS REFERRED TO AS "METERING 
CELLS” © 
] EXTRACTING DATA: THIS IS PERFORMED BY NUMEROUS METERING 
COMMANDS WHICH (WHEN INVOKED) 
| READ AND STORE THE CURRENT VALUES OF RELEVANT METERING 
CELLS 
| REPORTING THE DATA: THIS IS PERFORMED BY THE METER COMMANDS 
WHICH (WHEN INVOKED) : 


} COMPARE CURRENT METERING CELL VALUES WITH PREVIOUSLY READ 
VALUES | . 


'] PERFORM THE APPROPRIATE ARITHMETIC COMPUTATIONS UPON THE 
DATA IN ORDER TO ARRIVE AT THE DESIRED STATISTIC 


. ARRANGE THE DATA IN A USEFUL FORMAT (A REPORT OR DIAGRAM) 
AND PRINT IT . 
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METERING & TUNING 


| TUNING 


J CHANGING THE SYSTEM'S OPERATING PARAMETERS AND /OR 
CONFIGURATION BASED UPON THE DATA AND INSIGHTS FROM THE 
-SYSTEM'S METERS 


® MAJOR DATA BASES 


) SST HEADER, TC_DATA HEADER, ETC. 
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INITIALI ZER.SYSDAEMON 


® FUNCTION 


f THE SYSTEM'S INITIALIZATION, ADMINISTRATIVE AND CONTROL PROCESS 
(Initializer.SysDaemon.z), RESPONSIBLE FOR: 


) INITIALIZING THE OPERATING SYSTEM AT BOOTLOAD, FOLLOWING 
SUCCESSFUL INITIALIZATION OF THE SUPERVISOR 


] ANSWERING SERVICE ieeoniata logout ) 

1 eee CREATION AND DESTRUCTION 

| MESSAGE COORDINATOR ee COORDINATION) 
t SYSTEM ADMINISTRATION FUNCTIONS 


1 SYSTEM ACCOUNTING FUNCTIONS 


& MAJOR DATA BASES, ALL KEPT IN >sci 
| ANSWER _TABLE 
[ ABSENTEE_USER_TABLE 


1 DAEMON _USER_TABLE 
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INITIALI ZER.SYSDAEMON 


| MASTER GROUP TABLE (MGT) 

| CHANNEL DEFINITION TABLE (CDT) 

| SYSTEM ADMINISTRATION TABLE (SAT) 
| PERSON NAME TABLE (PNT) 


J PROJECT DEFINITION TABLES (PDT'S) 
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WHAT IS A PROCESS 


@® A MULTICS PROCESS IS A WELL DEFINED COLLECTION OF SEGMENTS, EACH 
WITH DEFINED ACCESS, OVER WHICH A SINGLE EXECUTION POINT IS FREE TO 
ROAM (I.E., FETCH INSTRUCTIONS AND MAKE DATA REFERENCES ) 


@ THE ADDRESS SPACE OF A PROCESS IS THE ABOVE "COLLECTION OF 
SEGMENTS". SUCH SEGMENTS ARE SAID TO BE KNOWN TO THE PROCESS 


® EVERY LOGGED IN USER HAS A PROCESS 


® VERY IMPORTANT CONCEPT: THE MULTICS SUPERVISOR RUNS IN THE USER'S 
PROCESS (IE: IN THE USER'S ADDRESS SPACE), BUT IN A DIFFERENT RING 


® A PROCESS TAKES ON THE IDENTITY OF THE SOFTWARE IT IS EXECUTING 
WHERE EVER IT GOES 


] WHEN A USER WISHES TO CREATE A SEGMENT, IT IS THE USER'S PROCESS 
WHIC EXECUTES THE SUPERVISOR CODE hces_Sappend, CREATING THE 
SEGMENT 


® A PROCESS CAN BE VIEWED AS A CONTINUAL FLOW OF EXECUTION 
FLUCTUATING BETWEEN DIFFERENT RINGS: PRIMARILY RING FOUR AND RING 
ZERO . | 
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WHAT IS A PROCESS 


PROCESS FLOW OF EXECUTION 


RING 
ee NN WROD «I 


ee a : , : : . 


@ ALL PROCEDURE CODE (WHETHER SUPERVISOR OR USER CODE) MUST HAVE A’ 
STACK FRAME CONTAINING ITS ARGUMENTS AND ENVIRONMENT DATA 


&® FOR REASONS OF SECURITY, MULTICS REQUIRES ONE STACK PER RING OF 
EXECUTION. WHEN EXECUTING RING "N" PROCEDURES, THERE WILL EXIST A 
RING "N" STACK CONTAINING STACK FRAMES FOR THESE PROCEDURES 
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STACK PER RING 


| FRAME 5 
FRAME 4 | 


FRAME 3 


FRAME 3 


fault 
STACK STACK | STACK 
HEADER HEADER. HEADER 
Seo tt 230 stack_O tt 231 stack_1- : Ht 234 stack_4 
(0,0,0) -(1,1,1) (4,4,4) 
SEVERAL (10-30) IN USER’S PROCESS IN USER‘S PROCESS 
PER SYSTEM, SHARED DIRECTORY DIRECTORY 


* PR7 1S THE STACK BASE POINTER REGISTER. POINTS TO CURRENT STACK. HARDWARE LOADED WITH 
DBR.stack *8 + RING. THE VALUE OF DBR.stack CAN CHANGE WITH EACH RELEASE. IT tS 23 IN MR10.1. 
. 
* PRG IS THE STACK FRAME POINTER REGISTER. POINTS TO CURRENT STACK FRAME. 
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COOPERATING PROCESSES 


BOA 
B 


byt 


L ACTIVE 
AUTON 


PROCESSES (INTERACTIVE, ABSENTEE, AND DAEMONS) APPEAR TO 
NOMOUS 


AND INDEPENDENT OF ONE ANOTHER 


& IN REALITY, ALL PROCESSES ARE CONTINUALLY COOPERATING, COMPETING 
AND SHARING 


. EXAMPLES OF COOPERATION 


) VOLUNTARY 


. THE SENDING AND ACCEPTING OF MESSAGES AND MAIL 


| PREPLANNED BY SYSTEM PROGRAMMERS 


J SVERY PROCESS, BEFORE RELINQUISHING A PROCESSOR, CHOOSES 
THE MOST DESERVING REPLACEMENT AND EXECUTES THE CODE.WHICH 
DISPATCHES THE CHOSEN PROCESS 


f EVERY PROCESS, WHEN RUNNING, WILL SERVICE ALL INTERRUPTS 
FIELDED BY ITS PROCESSOR. THESE INTERRUPTS ARE GENERALLY 
THE REPLIES TO THE REQUESTS OF OTHER PROCESSES (IE: THE 
ARRIVAL OF A PAGE REQUESTED SOME TIME Sanam 


) PREPLANNED BY APPLICATION PROGRAMMERS 


) THE MULTICS TRANSACTION PROCESSOR iS COMPOSED OF MANY 
COOPERATING, INTER-DEPENDENT PROCESSES 


| EXAMPLES OF COMPETITION 


Jf ALL PROCESSES COMPETE FOR PROCESSOR TIME AND MAIN MEMORY 
RESOURCES 
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COOPERATING PROCESSES 


f THIS COMPETITION IS HIGHLY REGULATED IN ORDER FOR ALL 
PROCESSES TO BE TREATED FAIRLY 


| THE COMPETITION IS ALSO SUBJECT TO VERSATILE ADMINISTRATIVE 
CONTROLS 


f EXAMPLES OF SHARING 


) BY DESIGN, A SIGNIFICANT PART OF THE ADDRESS SPACE OF ALL 
PROCESSES IS IDENTICAL (THE SUPERVISOR SEGMENTS ) 


BY DEFAULT, . REFERENCES TO SEGMENT foo BY TWO DIFFERENT. 
PROCESSES WILL RESULT IN REFERENCES TO THE SAME SEGMENT 
(LOGICALLY, PHYSICALLY, ACTUALLY AND ABSOLUTELY) 


THERE IS NO SEPARATE ENTITY IN MULTICS LIKE AN EXECUTIVE DOING 
THINGS ON BEHALF OF THE USER. THE Initializer.SysDaemon IS NOT THE 
TIME-SHARE EXECUTIVE OF MULTICS | 
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PROCESS A 


PROCESS B. 
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THE PL/I OPERATORS 


@® OPERATORS ARE LANGUAGE DEPENDENT PIECES OF CODE WHICH IMPLEMENT 
HARDWARE OR OPERATING-SYSTEM DEPENDENT FUNCTIONS SUCH AS CALLING 
AND SIGNALLING 


@® CURRENTLY THERE ARE OPERATORS FOR PL/I, COBOL, AND BASIC. ALM AND | 
FORTRAN SHARE THE PL/I OPERATORS 


® ALL OPERATORS IN MULTICS ARE PURE, SHARED AND RE-ENTRANT ALM CODE 


® OPERATORS COULD BE GENERATED BY THE COMPILERS AND PLACED IN LINE 
WITH OTHER CODE, HOWEVER, THERE ARE DISADVANTAGES: 


] SOME OPERATORS ARE TOO BULKY TO BE INCLUDED WITH EACH USE (SUCH 
AS COMPLICATED 1/0 STATEMENTS ) 


f SOME OPERATORS MIGHT CHANGE IN THE FUTURE (SUCH AS ENTRY AND 
RETURN SEQUENCES ) 7 


® OPERATORS ARE SIMILAR TO QUICK INTERNAL PROCEDURES IMPLEMENTING 
WHAT IS OFTEN CALLED "LIBRARY FUNCTIONS” IN OTHER OPERATING SYSTEMS 
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THE PL/I OPERATORS 


INSTEAD OF PASSING ARGUMENT LIST, ARGUMENTS ARE USUALLY PASSED TO 
THE OPERATORS IN THE CPU'S REGISTERS 


INSTEAD OF BEING CALLED BY A PROCEDURE CALL, A SINGLE TRANSFER 
INSTRUCTION IS USED (tsx0 or tsp3) 


THE. PL/I OPERATORS IMPLEMENT THE SUPPORT FUNCTIONS FOR THE PL/I 
ENVIRONMENT 


SINCE A MULTICS PROCESS IS A PL/I ENVIRONMENT, THE DL /t OPERATORS 
ARE VITAL TO THE MULTICS SUPERVISOR (AND ANY OTHER PROGRAMS WRITTEN 
IN PL/T) 
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INTERFACES TO SYSTEM MODULES 


@® UNLIKE OTHER SUPERVISORS, THE MULTICS SUPERVISOR IS NOT SEQUENTIAL 
- THAT IS, THE CONCEPT OF "JOB FLOW" DOES NOT REALLY APPLY 


] INSTEAD, THE SUBSYSTEMS PERFORM ASYNCHRONOUSLY, BEING 'INVOKED' 
BY THOSE PROCESSES WHO REQUIRE THEIR SERVICES 


| THESE SUBSYSTEMS ARE INVOKED BY THE USER'S PROCESS IN ONE OF 
THREE WAYS: - 


J EXPLICITLY - VIA A SUBROUTINE CALL OR A COMMAND 


. IMPLICITLY - VIA A FAULT m | 
OTT calersoGle $0 VEY S) na 2» ASV ovec ted. 


1 IMPLICITLY - VIA AN INTERRUPT 


SUPERVISOR 
SUBSYSTEM 


INTERRUPT SIDE 


CALL SIDE: SERVICES PERFORMED AS A RESULT OF EXPLICIT 
SUBROUTINE CALLS. LOCKS ARE NORMALLY 
WAIT LOCKS. 

FAULT SIDE: SERVICES PERFORMED AS A RESULT OF FAULTS. 


LOCKS ARE NORMALLY WAIT LOCKS. 


INTERRUPT SIDE: SERVICE PERFORMED AS A RESULT OF INTERRUPTS. 
LOCKS ARE LOOP LOCKS. 
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DEADLOCK PREVENTION 


® WHAT IS. DEADLOCK? 


J DEADLOCK CAN OCCUR IN ANY MULTI-PROGRAMMING ENVIRONMENT WHEN TWO 
OR MORE PROCESSES COMPETE RANDOMLY FOR SERIALLY REUSABLE 
RESOURCES | , 


[ THE CLASSIC EXAMPLE OF DEADLOCK IS THE "DEADLY EMBRACE" 


PROCESS 


PROCESS 
A B 


DEADLY EMBRACE > 


e PROCESS A IS WAITING FOR A RESOURCE OWNED BY PROCESS B. 


e PROCESS B IS WAITING FOR A RESOURCE OWNED BY PROCESS A. 
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DEADLOCK PREVENTION 


@® DEADLOCK SOLUTIONS 


) DETECTION AND UNLOCKING 


SOME SYSTEMS EMPLOY SCHEMES WHICH DETECT THE OCCURRENCE OF 
DEADLOCK AND "UNTANGLE" THE INVOLVED PROCESSES ~ 


DETECTION SCHEMES ARE USUALLY DIFFICULT TO 
EXPENSIVE IN TERMS OF OVERHEAD 


IMPLEMENT AND 


THE ACT OF UNTANGLING THE INVOLVED PROCESSES USUALLY RESULTS 
IN AT LEAST ONE OF THEM LOSING RESOURCES, PRIORITY, OR EVEN 
ITS: DIFE 


| PREVENTION 


—=—= 


MOST SYSTEMS ADOPT SOME 
DETECTION: 


FORM OF PREVENTION INSTEAD OF 


J CHECKING: WHEREBY REQUEST 
DEADLOCK POTENTIAL PRIOR T 


on 


IMPOSED POLICY: WHEREBY 
RESOURCE MUST BE MADE: 


FOR MORE THAN ONE 


] TOGETHER AS ONE TOTAL REQUEST BEFORE THE 
"JOB-STEP” COMMENCES (ALL OR NOTHING); OR 


"JOB" OR 


f SERIALLY, IN A FIZED, PRE-DEFINED ORDER 


B 


DEADLOCK PREVENTION 


MULTICS, IN GENERAL, ADOPTS THE FOLLOWING DEADLOCK PREVENTION 
SCHEME : 


USER ASSIGNABLE RESOURCES (SUCH AS TAPE DRIVES, CARD PUNCHES, 
ETC) 


] WHEN THE USER IS INTERACTIVE NO POLICY IS ENFORCED. THE USER 
IS INFORMED IF THE RESOURCE IS BUSY AND MAY EITHER TRY AGAIN 
OR GIVE UP 


] WHEN THE USER IS NOT INTERACTIVE, THE "ALL" OR "NONE” . 
APPROACH SHOULD BE USED. THE AVAILABILITY OF ALL REQUIRED 
RESOURCES BECOMES THE DETERMINING FACTOR IN SCHEDULING THE . 
USER (SEE THE "RESOURCE CONTROL PACKAGE") 


) SHOULD A NON-INTERACTIVE USER ATTEMPT SERIAL REQUESTS FOR © 
RESOURCES, A DEADLOCK SITUATION COULD POTENTIALLY ARISE AND 
EZIST UNTIL THE AUTOMATIC LOGOUT DUE TO INACTIVITY OCCURS 


USER ACCESSIBLE RESOURCES (SUCH AS FILES, DATA BASES, ETC) 


) IN GENERAL, USER SEGMENTS IN THE’ HIERARCHY POSE NO DEADLOCK 
PROBLEM SINCE THEY ARE A SIMULTANEOUSLY USABLE RESOURCE (IE: 
THERE IS NO DEFAULT CONCURRENCY MECHANISM ASSOCIATED WITH 
USER SEGMENTS ) 


) SEGMENTS MAY BE PROTECTED FROM POTENTIAL CONCURRENCY PROBLEMS 
THROUGH USE OF LOCK WORDS AND THE set_lock MECHANISM. THIS 
REQUIRES MUTUAL AGREEMENT AMONG ALL PROCESSES ACCESSING SUCH 
SEGMENTS . 


J SOME SEGMENTS SUCH AS THOSE USED BY THE MULTICS DATA BASE 
MANAGER (MDBM), USE A "COMMITMENT/ROLLBACK” SCHEME 
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DEADLOCK PREVENTION 


f SUPERVISOR RESOURCES (SUCH AS HARDCORE DATABASE) 
: (is ANAS ) vars ) 
f LOCKWORDS (OR SIMPLY "LOCKS") ARE USED IN MULTICS TO 


IMPLEMENT CONCURRENT ACCESS CONTROL IN THE MULTI-PROCESS 
ENVIRONMENT 


LOCKING CONCEPT 


| UNLOCK 
UPDATE 


] THE SUPERVISOR LOCKS ARE ARRANGED INA PARTIAL CRDER AND A 
CODING CONVENTION PREVENTS WAITING ON A LOCK IF THE PROCESS 
HAS A HIGHER LOCK LOCKED 


J .THIS PARTIAL ORDER IS DETERMINED BY AN ANALYSIS OF THE 
OPERATING SYSTEM'S BEHAVIOR. FOR EXAMPLE: SINCE A PAGE 
FAULT MAY PROPERLY OCCUR WHILE A PROCESS HAS THE ACTIVE 
SEGMENT TABLE (AST) LOCKED, AND PAGE FAULT HANDLING REQUIRES 
THE LOCKING OF THE PAGE TABLE LOCK, THE PAGE TABLE LOCK MUST 
BE PLACED "HIGHER" IN THE PARTIAL ORDER THAN THE AST LOCK 


{ TO THE DEGREE THAT THE SYSTEM . PROGRAMMERS OBEY THIS PARTIAL 
ORDER, A DEADLY EMBRACE CANNOT OCCUR WITHIN THE MULTICS 
SUPERVISOR 


&) 
j 
1-2 
Gy) 
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MULTICS LOCKING HIERARCHY 


_ 1/0 MAILBOX 
(LOOP) 


CONNECT GLOBAL APT APT ENTRY CORE QUEUE ws OCDCM SYSERR DATA MCS QUEUE 
(LOOP) (MULTI-READER (LOOP) (LOOP) - : (LOOP) (LOOP) (LOOP) . (LOOP) 


(LOOP) \ 7 
Se ee ee 


GLOBAL PAGE TABLE 
(LOOP/WAIT) 


VTOC BUFFER SEGMENT 
(WAIT) 


ACTIVE SEGMENT TABLE 
(WAIT) . 


NOLLNGASuad Woo avad 


DIRECTORY LOCK TABLE 
(WAIT) 


ROOT DIRECTORY 
(MULTI-READER, WAIT) 


LOWER DIRECTORY 
(MULTI-READER, WAIT) 


MISCELLANEOUS: IOAT, IO}, | | a SYSERR LOG MCS CHANNEL 
SALV_DATA, RECONFIGURATION : (WAIT) (LOOP/WAIT) 
(WAIT) a . 


TYPES OF LOCKS 


= LOCKS WITHIN MULTICS: Veex oC All 


a VAT CL SkT 


) ARE 36 BIT WORDS CONTAINING EITHER ZERO (UNLOCKED) OR A 
PROCESS _ID (LOCKED) 


USuaiy nent Bew.n9 \noy oe 
) CONTROL PROCESSES, NOT PROCESSORS 


J ARE MUTUALLY EXCLUSIVE LOCKS 


] THE HARDWARE SUPPORTS SEVERAL INDIVISIBLE INSTRUCTIONS USED IN 
IMPLEMENTING THE LOCKING PRIMITIVES. FOR EXAMPLE: 


[ STAC (STORE A CONDITIONAL) 


J IF C(¥)=0 THEN C(A) -> C(Y) 


TYPICAL USE: LOCKING. IF THE LOCKWORD (Y) IS UNLOCKED (=0) 
THEN LOCK THE LOCK BY STORING THE PROCESS ID (WHICH IS IN A) 
INTO THE LOCKWORD 


( SPECIAL HARDWARE PROHIBITS SIMILAR REFERENCES S8Y OTHER 
PROCESSORS DURING THE TEST AND DATA TRANSFER WINDOW 


) ALSO STACQ (STORE A CONDITIONAL ON Q), LDAC (LOAD A AND CLEAR), 
LDOC (LOAD Q ~ AND CLEAR), SZNC (SET Z “AND N AND ~ CLEAR) 
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TYPES OF LOCKS 


8 WITHIN THE MULTICS SUPERVISOR EXISTS TWO TYPES OF LOCKS: LOOP 
LOCKS AND WAIT LOCKS 


LOOP LOCKS 


J SIMPLIFIED PL/I ANALOGY: 


do while (lockword *=0); 
end; 

lockword = process id; 
<upGate data> 

lockword = 0; 


J LOOP LOCKS ARE USED WHEN IT WOULD NOT BE ACCEPTABLE TO GIVE 
UP THE PROCESSOR BEFORE LOCKING THE LOCK. 


fi LOOP LOCKS TYPICALLY PROTECT THE LOWEST LEVEL OF CRITICAL 
SUPERVISOR DATABASES: TRAFFIC CONTROL, PAGE CONTROL, ETC. 
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TYPES OF LOCKS 


WAIT LOCKS — (SIMPLIFIED) 


A: PROCESS GIVES UP THE CPU 


B: PROCESS DISPATCHED TO A CPU 


SIMPLIFIED PL/I ANALOGY: 

do while (lockword “*=0); 
<GIVE UP PROCESSOR> 
<WAIT FOR NOTIFICATION> 


end; 

Lockword = process id; 
<Uccace Gace 

Lockword = Q 

<SEND NOTIFICATION> 


MOST SUPERVISOR LOCKS ARE WAIT LOCKS 


IN GENERAL, A PROCESS IS ALLOWED .TO GIVE UP ITS PROCESSOR 


WHEN IT HAS WAIT LOCKS LOCKED 


THE WAIT LOCK MECHANISM WILL BE DESCRIBED IN MORE DETAIL IN 


TOPIC 9 
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TOPIC iV 


Name Space and Address Space Management 


Name/Address Space 
Name/Address Space 
Name/Address Space 
Name/Address Space 

Reference Name 


Overview. . 
Terminology 
Concepts. . 
Data Bases. 
Table (RNT) 


Known Segment Table (KST). 
Descriptor Segment (DSEG). 
Typical Address Space. .... 


Name/Address. Space 


system_link_meters ... 


link_meters. . 
Name/Address Space 


display _kst_entry. ... 


Meters. . 


Commands. 
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NAME/ADDRESS SPACE OVERVIEW 
\ 


Al aanlt Ae \Afo tS (Gare Addees sable 


FUNCTION Tl iy ae madt — Crocesgen ttkesadte Wo Sas 


Gre LeFeucratl 


IMPLEMENT THE PER PROCESS VIRTUAL MEMORY 


Know ~ Se OS 


BASIC PHILOSOPHY 


AS A NEWLY LOGGED IN USER ATTEMPTS TO TOUCH VARIOUS SEGMENTS A 
CONSIDERABLE AMOUNT OF MANAGEMENT INFORMATION MUST BE 
( TRANSPARENTLY ) FOUND AND/OR COMPUTED BEFORE THE USER'S 
REFERENCE IS ACTUALLY ACCOMPLISHED 


FOR EVERY SEGMENT REFERENCED BY THE USER, THE SUPERVISOR: 


f ASSIGNS A SEGMENT NUMBER (FOR REASON OF HARDWARE ADDRESSING), 
AND 


Petre TR PTS 


aranr Tare + 
4M SLAIN AAS Loa 2 aN 


RS) 
SNCY AND CONTROL) 


L —t J 
i 


SUCH SEGMENTS ARE SAID TO BE "KNOWN TO TEE PROCESS" 


THE MANAGEMENT INFORMATION IS MAINTAINED ON A PER PROCESS BASIS 
IN THREE COMPLEMENTING AREAS: ODSEG, KST, AND RNT 
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NAME /ADDRESS SPACE OVERVIEW 


J MANAGES TWO DISTINCT SETS OF INFORMATION: 


J ADDRESS SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND 
THE SEGMENTS THEMSELVES | 


| NAME SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND NAMES 
THE USER REFERS TO THEM BY | 
Larthared S96 


1 CALLS DIRECTORY CONTROL TO LOCATE SEGMENTS INITIALLY 


J NAME SPACE / ADDRESS SPACE MANAGEMENT IS INVOKED BY SUBROUTINE 
CALLS, AND BY LINKAGE FAULTS (THE "DYNAMIC LINKER") 


® PRINCIPAL USER INTERFACES 


| COMMAND LEVEL 


{ initiate, terminate, terminate_segno, terminate _ref name, 
terminate_single ref_name, list_ref_name 


) THE COMMAND PROCESSOR ITSELF - WHICH USES THESE SERVICES TO 
LOCATE COMMANDS 


| SUBROUTINE LEVEL 


] hes_Sinitiate, hes_S$initiate_count_, hces_Sterminate_file, 
hes_Sterminate_seg, hes_Sterminate_name, 
hes_Sterminate_noname, term_ : 
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NAME/ADDRESS SPACE OVERVIEW 


MAJOR DATA BASES 


l 


df 


anvey oF Sou! S 


DESCRIPTOR SEGMENT (DSEG) - ONE PER PROCESS 
) SEGMENT DESCRIPTOR WORD (SDW) - ONE PER KNOWN SEGMENT 


] DEFINES THE USER'S ADDRESS SPACE TO THE HARDWARE 


KNOWN SEGMENT TABLE (KST) - ONE PER PROCESS 


KNOWN SEGMENT TABLE ENTRY (KSTE) - ONE PER KNOWN SEGMENT 
(EXCEPT SUPERVISOR SEGMENTS) 


—. 


DEFINES THE USER'S ADDRESS SPACE TO THE SUPERVISOR AND THE 
USER 


BACH KSTE ASSOCIATES A USER'S SEGMENT NUMBER WITH THE SEGMENT 
CONTROL ATTRIBUTES OF THAT SEGMENT ~ 


THE SEARCH FOR AN AVAILABLE KSTE DETERMINES A SEGMENT'S 
NUMBER 


REFERENCE NAME TABLE (RNT) - ONE PER EACH RING IN BEACH PROCESS 


NOT A SEGMENT - KEPT AS A REGION ALLOCATED IN THE "LINKAGE 
AREA" FOR EACH RING 


REFERENCE NAME TABLE ENTRY (RNTE) - ONE PER REFERENCE NAME 


USED BY THE DYNAMIC LINKER TO IMPLEMENT THE 
"initiated_segments” SEARCH RULE 
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NAME /ADDRESS SPACE OVERVIEW 


) DEFINES THE USER'S NAME SPACE TO THE USER 


f NAME SPACE MAY BE DIFFERENT IN DIFFERENT RINGS OF THE SAME 
PROCESS 
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NAME /ADDRESS SPACE TERMINOLOGY 


SEGMENT DESCRIPTOR WORD (SDW): 
A TWO WORD PAIR USED BY THE HARDWARE WHEN REFERENCING A 
SEGMENT. 


DESCRIPTOR SEGMENT (DSEG): 
THE MOST FUNDAMENTALLY IMPORTANT SEGMENT IN A PROCESS. 
CONTAINS AN ARRAY OF SDW'S DEFINING THE ADDRESS SPACE 
OF THE PROCESS 


ADDRESS SPACE: 
THE SET OF ALL SEGMENTS (PROCEDURE AND DATA) FOR WHICH 
THE PROCESS HAS A SEGMENT NUMBER AND A CORRESPONDING 
SDW. THE ADDRESS SPACE EXPANDS AND CONTRACTS DURING A 
~SEGMENT'S LIFE 


Al oe 4 Jvct eT Ka Gyz R he rd ad ve 1 Ly ( 
as ] wn Ww e ) WH \S OF 


Sat e ROT J four vale 
SEGMENT NUMBER: 
AG NOMBER’ .-C-1777 -(0=1022 
UNIQUELY TO A SEGMENT. USED BY T 
OFFSET INTO THE ARRAY OF SDW'S WHEN R 
SEGMENT 


tJ 


ARE AS AN 
ERENCING A 


MAKING KNOWN: 
THE ACT OF ASSIGNING A SEGMENT NUMBER TO A SEGMENT, 
THEREBY ADDING IT TO THE ADDRESS SPACE. SEGMENTS MUST 
BE MADE KNOWN BEFORE THEY CAN BE REFERENCED 


of 
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NAME /ADDRESS SPACE TERMINOLOGY 


THE SET OF ALL SEGMENTS FOR WHICH THE PROCESS HAS A 
REFERENCE NAME. THE REFERENCE NAME MAY BE DIFFERENT 
THAN THE SEGMENTS ACTUAL NAME (ITS ENTRYNAME). SINCE 
SOME SEGMENTS IN THE ADDRESS SPACE HAVE NO REFERENCE 
NAME, THE NAME SPACE IS A PROPER SUBSET OF THE ADDRESS 
SPACE 
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NAME /ADDRESS SPACE CONCEPTS 


@ A MULTICS PROCESS IS A WELL DEFINED COLLECTION OF UNIQUE SEGMENTS, 
EACH WITH DEFINED ACCESS, OVER WHICH A SINGLE EXECUTION POINT I5 
FREE TO ROAM (I1.E., FETCH INSTRUCTIONS AND MAKE DATA REFERENCES ) 


e® THE ADDRESS SPACE OF A PROCESS IS THE ABOVE "COLLECTION OF 


SEGMENTS". SUCH SEGMENTS ARE SAID TO BE KNOWN TO THE PROCESS 


J ALL SUPERVISOR (RING 0) SEGMENTS ARE PLACED INTO THE ADDRESS 
SPACE AT PROCESS CREATION TIME. THIS ADDRESS SPACE IS SAID TO 


BE "CLONED" FROM THE INITIALIZER ADDRESS SPACE 


1 THE RING ZERO ADDRESS SPACE IN ANY PROCESS IS THE SAME AS THE 


INITIALIZER'S RING ZERO ADDRESS SPACE, EXCEPT FOR 
KST, PDS, PRDS, AND. STACK _0, 


. THE RING ZERO ADDRESS SPACE HAS NO RNT, BECAUSE IT 


URING a ee sag vier oad AND DOES NOT CHANGE 
ws VSe Donn AYR AY Cc WS Ae a) boty 


) IMPLICITLY BY THE DYNAMIC LINKER (LINKAGE FAULT) OR 


COMMAND 
print my_dir>my_seg 


tester 


ThE 


LS 


DSEG ; 


J EXPLICITLY BY COMMANDS OR SUBROUTINES THAT MANAGE THE ADDRESS 


SPACE 


initiate my_prog call hces_Sterminate_segno 
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NAME /ADDRESS SPACE CONCEPTS 


f MAKING A SEGMENT KNOWN IS SIMILAR TO DECLARING A VARIABLE IN A 
PL/I PROGRAM. IT SIGNIFIES INTENT, BUT NOT USAGE 


Vesatvee Slot \n KS 


THE PRESENCE OF ONE OR MORE PAGES OF A SEGMENT IN } J 
IMPLIES THAT THE SEGMENT IS KNOWN TO (AND IS’ BEING USED 
LEAST O . 


. BEING KNOWN DOES NOT IMPLY PRESENCE IN MAIN MEMORY 


= NOTE THAT THIS .SET OF SEGMENTS, THE EXECUTION. POINT, -AND THE. 
"REGISTERS AND INDICATORS OF THE PROCESSOR, UNIQUELY DEFINES THE 
STATE OF THE PROCESS 
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NAME /ADDRESS SPACE CONCEPTS 


NAME SPACE AND ADDRESS SPACE MANIPULATION 


© 


PROCESS CREATION 


(2) INITIATE WITHOUT USER'S 
| REFERENCENAME ____(make_known) ADDRESS 
| SPACE 
| USER'S [pd] a) 
; NAME [ pd] >kst 
@) INITIATE WIT | ite 
NITIATE WITH * 
REFERENCE NAME J (Cpd yeas seaess. 
pee tan ae ee 
= = 
Lj bd —_ 
3 2 
fi 26 
Fam zo 
eae 


* THE mnt IS AN AREA WITHIN [pd] > [unique] .area.linker 
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267 qedx 


272 cwd 


266 plt 


_ RNT 


(USER’S NAME SPACE) 


* THE ASTE’S ASSOCIATED WITH THE PAGE TABLES ARE NOT SHOWN IN THIS DIAGRAM 


NAME SPACE AND ADDRESS SPACE MANAGEMENT 


KST 


271 SDW 


270 |. SDW 
267 SDW 
266 SDW 


(USER’S ADDRESS SPACE) 


PER PROCESS 
DATA BASES 


FOR cwd 
FOR seg_3 
FOR qedx 


FOR pit 


DSEG 


PER SYSTEM 


DATA BASES 


PT FOR qedx 


PT FOR seg_1 7 


PT FOR pl1 


PT FOR A.pi1 


PAGE TABLES* 


(SYSTEM’S ADDRESS SPACE) 


PAGE 4 OF qedx 


PAGE 3 OF pl 


PAGE 41 OF xyz 


PAGE 16 OF pl1 


MAIN MEMORY 


SNYN 


SL@SONOO FOVdS SSAUAACY 


1} 
16.9) 
oO 
ke 


SMALLEST UNIT 
OF ACCESS 


CONTROL 


MULTICS VIRTUAL MEMORY STRUCTURE 


USER A‘s USER A's USER A’s 
ADDRESS SPACE VIRTUAL MEMORY SEGMENT TABLE 


$_ data C 


i 


iom-mailbox 
fault vector 


dseg 


Ai 


tom_ mailbox = 


fault_ vector 


REAL MEMORY 


' 


USER B's | USER B's USER B's SYSTEM'S PAGE 


ADDRESS SPACE VIRTUAL MEMORY SEGMENT TABLE TABLES 
(ONE ENTRY PER (ONE PER ACTIVE 
KNOWN SEGMENT) SEGMENT) 


SS3eacy/ GNVYN 


SidZONOO govdS 


POINTER TO ALLOCATION AREA 


: 
, 
4 GET_ sade TRYS GET_RNAME WINS 

| 
| 


7 : : RNT AREA SIZE 


GANT FAC ACE TA oe 


SEARCH RULES POINTER 


9 
10 
128 WORDS FOR 
REFERENCE NAME HASH TABLE 
138 


128 WORDS FOR 
SEGMENT NUMBER HASH TABLE 


fa) NAME FORWARD R_PTR (TO SAME HASH) 
i SEG_NO FORWARD R_PTR (TO SAME HASH) 


2 SEG_NO NAME LENGTH {L) 


ee |+———_____ 


vi 
3S 
Sa CU en em a TSI 22 
eao<d 
L CHARACTERS CONTAINING 
SEGMENT’S REFERENCE NAME 
t 
ae 
hb hab 
=r 
me SZ 
on-4 


A SSE SR, (Fb O 


(WORDS) : (rntanet.ptti 


REFERENCE NAME TABLE (RNT) 


A PAGED DATA BASE ( [pd] > rnt) - ONE PER ACTIVE PROCESS 
“INITIATED SEGMENTS” IN SEARCH RULES 


REFERENCE NAME TABLE ENTRY (RNTE) 


ONE PER REFERENCE NAME 
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NAME /ADDRESS SPACE DATA BASES 


KNOWN SEGMENT TABLE (KST) 


Spee. ee. Car See “BU 2 i? SG 
2 a} 2 


LOWEST SEGMENT NUMBER 


ae) 
a 


HIGHEST SEGMENT NUMBER 


HIGHEST SEGMENT NUMBER YET USED 


NUMBER OF PRIVATE LOGICAL VOLUMES 


TIME OF BOOTLOAD 


NO. OF KST GARBAGE COLLECTIONS NO. OF KST ENTRIES RECOVERED 


FIRST FREE KSTE R_PTR 


SEGMENT NUMBER 


wR | ae | sae 
RING RING re INF COUNT OR LV INDEX 


OTHER KSTE’s 
ONE PER INITIATED SEGMENT 


256 WORD LIST OF PRIVATE LOGICAL 
VOLUME CONNECTIONS 


-WORDS) _ ee 
KNOWN SEGMENT TABLE (KST 


3 PER PROCESS OATA BASE (pa: > «st! ONE PER ACTIVE PRACCESS 
NOT WIRED ENCACHEAGLE: 


KNOWN SEGMENT TABLE ENTRY KSTE: 
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DESCRIPTOR SEGMENT (DSEG) " 
nee A PAGED ([pd] > dseg) DATA BASE — ONE PER ACTIVE PROCESS 
SEGMENT DESCRIPTOR WORD (SDW) 
ONE PER INITIATED SEGMENT IN PROCESS (MAX 1024) © 
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NAME/ADDRESS SPACE DATA BASES 


DESCRIPTOR SEGMENT (DSEG) 


SEGMENTS IN THE MULTICS HIERARCHY 


-INITIATED WITH SS 


REFERENCE N 
DERSC cme! IN USER’S RNT 


o 


NOT IN USER‘S RNT = 


as teh eens 


INITIATED WITHOUT “f= 
REFERENCE NAME 


_2 INITIATE 


. GS: NOT IN USER‘S KST 
SUPERVISOR foe 
SEGMENTS 


MUST CONNECT USER >=== NOT IN USER‘S DSEG 
TO CURRENTLY ACTIVE ee : 

SEGMENT —OR— 
RECONNECT BECAUSE 


OF ACL CHANGE, POOL 23: 
PROMOTION, ETC. VALID SDW: as 


at 


ACTIVE SEGMENTS 


wae Stag ete 


2 
a 
< 
m 
> 
” 
| 


2 ACTIVATE 


HAS APAGE = =:3= DOES NOT HAVE A PAGE TABLE 


—_ PER SYSTEM STATES a es PER PROCESS STATES sesecee S| 


UNPAGED HGBES 
SUPERVISOR | : 
SEGMENTS ~<— Sees 
IN MAIN 2" 
MEMORY: 35 : NOT IN MAIN MEMORY 
pare 
STATES OF SEGMENTS AND PAGES 
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TYPICAL ADDRESS SPACE 


SEGMENTS WHICH MUST BE PRESENT TO RUN THE VERY FIRST LOADING 
PROGRAN 


SEGMENTS WHICH HAVE FIXED ABSOLUTE ADDRESSES TO INTERFACE WITH 
HARDWARE 


ALL DESCRIBED IN template_sit_.cds 


[pd] >dseg (ring 0) 
The descriptor segment. The initializer’s dseg 
comes from the system tape and is built during 
system initialization; ali others are created by 
process creation. 


Ffault_vector (ring 0, perm-wired) 
Contains the interrupt vector, fault vector, and the 
ITS pairs for SCU and TRA instructions. Located at 
absolute locations 0-577. Used by the CPU hardware. 


jom_mai ]box (ring 0, perm-wired) 
Mailboxes (communications areas} for up to four 


1OMs. Located at locations 1200-3377 absolute. 
Used by the IOM hardware. 


>s1l>config_deck (ring 0, deciduous) 
The online copy of the config deck. This is built 
from the config deck provided by 80S during system 
initialization, but it is mot the copy BOS actualiy 
uses. 


dn355_mai lbox ? (ring 0) 
Mailboxes (communications areas) for up to eight 
rNPs. Located at absolute locations 3400-6377. 
Used by the FNP hardware. 


bos_toehold (ring 0, perm-wired) 
The segment containing the tiny program used to 
switch between Multics and BOS at crash time. 
Located at absolute locations 10000-11777. 
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TYPICAL ADDRESS SPACE > 


& flagbox (ring 
A region inside the bos_toehold segment (yes, it 
really overlaps the toehold) used to access the 
BOS/Multics communication region. 


‘J >slil>sit (ring 
10 >s11l>name_table (ring 
The two primary databases of system initialization. 
The SLT contains one entry for every supervisor 
segment read from the system boot tape, containing 


all its attributes. The separate name_table is used 
to hold the names, because each segment may have 
several 


O, perm-wired) 


0, deciduous) 
0, deciauous) 


This marks the end of Collection Zero. All the rest of the segments in the 
address space are either read from the system tape or found in the online 


system. 
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TYPICAL ADDRESS SPACE 


@ COLLECTION ONE 
I FIRST BATCH OF SEGMENTS READ FROM SYSTEM TAPE 
I ALL THE PROGRAMS AND DATABASES NEEDED TO MAKE PAGING RUN 


I ALL SEGMENTS WHICH MUST BE ''perm-wired'! -- PERMANENTLY ALLOCATED IN 
LOW MEMORY, WITHOUT PAGE TABLES , 


11 Tot | . EE ee uk arte : _. {ring 0). 
- - The supervisor ’s linkage offset table. Used to find 
linkage sections. Built as the segments are read in 

from tape. 


12. as_linkage © (ring 0) 

13. ws_linkage . (ring 0). 
The permanent supervisor combined linkage regions. 
The names mean "Active Supervisor Linkage" and 
"Wired Supervisor Linkage", respectively. The 
linkage sections of ail permanent supervisor 
segments are put in one of these as the segments are 
read from the tape. 


1h >sllodefinitions_ : (ring 0, deciduous) 
“" -. The segment containing all the definitions sections 

of supervisor programs. The definitions sections 

are placed here as the programs are read from the 

tape, and used by the hardcore prelinker. 


1§ sst_seg . | (ring 0, perm-wired) 
The segment containing all ASTEsS and page tables. 
Covered in under Page and Segment Control. This 
segment is allocated at the very. top end of the 
bootload SCU. 


16 core_map — | . (ring 0, perm-wired) 
All the core map entries, describing all system ; 
memory. Covered under Page Control. This used to 
be part of the SST, but was moved ‘out to make more 
room for page tables. 


17 abs_seg . (ring 0, abs-seg) 
An abs-seg used for complex call-side operations in 
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TYPICAL ADDRESS SPACE 


page control, such |. as evict_page and — 


reconfiguration. 


; (ring 
An abs-seg used only by page control for checking 
page frame contents for zeros, and zeroing newly 
allocated page frames. 


backup_abs_seg (ring 
An abs-seg used to access the segment being dumped 


O, abs-seg) 


0, abs-seg) 


in a Volume Dumper process. It is given an SDW. 


which refers to any ordinary segment. This is a 


very special hardcore segment, because it has. 


trailer entries, and it is special-cased by the 
trailer ‘manipulation program, setfau!ts. Norma] 
hardcore segments never receive trailers, since they 


_ are never activated or deactivated. 


fim_abs_seg (ring 
An abs-seg used by the FIM to do something 


isolts_abs_ seg. | | (ring 


An abs-seg used by ISOLTS, which gives. it an SDW 
describing the low 64K of the SCU being used for 
ISOLTS testing. 


volmap_abs_seg ; _ (ring 
An abs-seg used by page control to access record 
stocks. It is given the SDW of whichever volume’s 
stock is needed... ~ ; 


bound_active_! ; (ring 


bound_disk_util (ring 
bound_disk_uti]_wired _ | {ring 
bound_error_active oP ae & (ring 
bound_error_wired | . i (ring 
bound_interceptors (ring 


This is where the FIM lives. . 


bound_io_wired | (ring 


bound_iom_support. (ring 
bound_page_contro] (ring 
bound_priv_]1 | (ring 
>s11>bound_sss_wired_ (ring 


This is where pll_operators_ and a whoie host of 
other miscellaneous subroutines Jive. It is wired 
in a very special way, because not ail of its 
contents need to be wired. In particular, only 
about half of pll_operators needs to be wired, and 
there is @ special hack in make_sdw.pli which finds 
the definition In the middie of pil_operators which 
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abds-seg) 


abs-seg) 


abs-seg) 


perm-wirea) 


perm-wirec) 
nerm-wired) 


perm-wired 


_perm-wired 


} 
) 
perm-wired). 
perm-wired) 
deciduous) 


nl 
(2.9) 
(o>) 
I> 


LO 

Lil bound_te_wired . (ring 

42 bound_unencacheable (ring 

43 dir_seg (ring 
An abs-seg now used only at process termination time 
tO loop through the deac process’s KST in order to 
fiush any trailers it had for active segments. 

Lu disk post_queue_seg (ring 
The segment where the core address: queue lives: see 
core_queue_man.aim. This jis discussed under Page 
Control. 3% _ 

45 disk_seg Ge . (ring 
The segment containing the disk DIM’s databases: 

device table, channel! table, and 1/0 queues. 

L6 dn355_data ; (ring 
The segment containing software . communications 
regions for the FNPs. This is not where FNP buffers 
are kept, but only the mailboxes that describe the 
buffers, and some control information. 

47 ds_seg | (ring 
The Se gnene used by setfaults when accessing another 
process ‘’s DSEG in order to remove a <trailer. 
Covered under Segment Control. 

50 . emergency_shutdown . . - (ring 
The procedure segment which starts an ESD. it is a 
separate segment because BOS has to be able to find 
it and transfer to it. . 

51 hardcore_sct_seg | (ring 
The segment containing the static condition table 
for ring zero; it’s just like the one which is kept 
in an outer ring stack header. The only static 
handlers in ring zero are those used to invoke the 
copy_on_write mechanism. 

52 idle_dsegs (ring 

53 idle_pdses | | (ring 
Two similar segments: they contain the DSEG and PDS 
segments for all the idle processes, al] in a row. 
When an idle process is constructed, the SDWs for 


TYPICAL ADDRESS SPACE 


marks the end of the wired portion, and makes an 
ASTE for bound_sss_wired_ which has all its pages up 
to and including that definition wired, and the rest 
unwired. 


bound_t¢c_priv ; (ring 
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_joi_abs_seg 


Cpdj>pds | 
_ The Process Data Segment. This contains all the’ 


TYPICAL ADDRESS SPACE 


its DSEG and POS are set up to point into the middle 
of one of these segments. 


ini t_processor (ring 

inzr_stkO . {ring 
The ‘stack segment used by the Initializer during 
initialization and shutdown. During normal 
operation, the Initializer participates in ordinary 
ring zero stack sharing. 


iobm_data ' (ring 
The database of iobm.pll, the 1/0 Buffer Manager. . 


The . abs-ség used. by ioiinterrupt.pll~ to access a 
: user ioi_ buffer at interrupt time, for storing 
status information. oan: 


ioi_data (ring 
The § database for joi_ -- describes ll 
user-accessabie, or potentially user-accessable 
devices. See the programs in bound_io_active and 
bound_io_wired. . 


iom_data (ring 
Describes the configuration of the [OMs, and 


software information about 10M channels. Contains. 


‘assignment information, software status queue 
location, and metering cells. . 


oc_data m7 ae : (ring 


The database for the ring zero operator ’s console 
mechanism. This is used by syserr in ring zero, and 


(ring 


0) 
Q) 


0, perm-wired) 


0, abs-seg) 


0, perm-wired) 


0, perm-wired) 


C, perm-wired) 


by the Initializer to write on the system console 


(but not message coordinator consoles). 


miscellaneous information that makes @ process 


unique to the supervisor, and need not be readily 


accessable “to other processes. Most per-process 
variables are referenced symbolically, such as 
pdsSprocessid, pdsSpage_fault_data (machine 
conditions for last page fault), ete. 


>sll>prds ’ {ring 
Like the PDS, but. per-processor. Contains the same 
sort of miscellaneous information, and is also used 
as the ring zero stack for certain types of faults 
(page faults, cennects, and timer runouts) and al! 
interrusts. There is a FROS oper processor, named 


tw 
— 


ring’ 


0, deciducus) 


CG, deciduous) 


ma) 
oo 
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>sll>cpu_A.prds, cpu_B.prds, etc. The PRDS segment 
in ring zero is changed at LDBR time to indicate the 
actual PROS of the processor that the process is 
going to run on; thus, it’s sort of an abs-seg. All 
PRDS ’s are wired, but have page tables. 


0, 


QO, 


0) 
0) 


deciduous) 


abs-seg) 


0, perm-wired) 


65 >sll>pvt (ring 
The Physical Volume Table. Described unver Volume 
Management and Page Control. 

66 rdisk_seg ‘(ring 
A PTW-type abs-seg (the only one where the PTW ever 
changes). Used only by the program read_disk, which 
does 1/0 to arbitrary pages on any disk, its 
aste.pvtx and PTW are switched around to indicate | 

_ the right page,. which is. faulted on and (if. needed) .. 
written back out: "by PeScleanup. 
°67 ee fault | ae ‘ ane ee! (ring 

70 return_to_ring 0_ . (ring 
These two procedures are used to implement the 
restarting of faults (such as a QUIT signal) from 
the user ring. .When a fault occurs, a frame is 
pushed on the user ring stack, with its owner set to 
be return_to_ring_0_. Additionally, the machine 
conditions for the fault are saved in ring zero (in 
the PDS) so that when restart_fault is called to 
restart apossibly modified set of SONS HE CONS: it 
can compare and validate. 

Jl seas {ring 
The System Controller Addressing Segment. This 
segment has a page overiaid ona page of every 
system controller. No data is ever accessed through 
this segment; its page table is not even in the SST, 
but in the SCS. It is used only for certain 
privileged instructions which require an effective 
address in an particular SCU in order to read or set 
control registers in the SCU. 

72 ses . (ring 
The System Configuration Segment. . It describes most 
of the hardware configuration, and contains various 
control words used by privileged control 
instructions. © 

73 signaller .. sed (ring 
The procedure which implements user ring fault 
signalling. | 
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104 


Not To Be Repreduced i= 
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>sl1>sst_names_ | (ring 
The SST name table. This is a debugging feature; it 
contains (when in use) the primary name 


corresponding to every segment in the AST. It can 
be maintained online, by use of the PARM ASTK config 
card, but usually is not. It is always filled in by 
FDUMP after a crash if it was not already in use. 


stack_0O_data (ring 


Data segment describing the available segments for 


use in ring zero stack sharing. These segments, 
seen later on as segment 230, are recorded here anc 
multiplexed among eligible processes. 


m, 


Stock’seg Te, SRR Ng AIRE NI Be SEEDS Be te 
The segment containing all in-core record and VTOCE 
stocks for use by page control and segment controi, 
and covered under those tcpics. 

>slil>sys_boot_info (ring 
A data segment containing information about the |/0 
devices (tape and disk) used during bootload. 

>s11>sys_info (ring 


Contains assorted global wired information snared by 
“the user ring and supervisor. Some is set during 
bootload, and some comes off the tape; none is 
modified after initialization is complete. 


syserr_data | (ring 
Pata segment for the lowest level of the syserr 
mechanism. Syserr messages are built and queued 
here, and sent to the console. They are also copied 


eut by the syserr logger hardcore process, into the 


_syserr_log. 


syserr_log ; (ring 
This segment overlays the LOG partition on some 

disk, which is used to reliably store syserr 
messages until they can be copied into the 
perm_syserr_log maintained in the Hierarchy. 


te_data (ring 
The traffic control data segment; contains al] 
traffic control data. Covered under Traffic 
Control. ; 

wired _hardcore_data . (ring 


Miscellaneous data used by the wired supervisor. 


Ww 
Aw 


0) 


0, 


deciduous) 


perm-wi red) 


perm-wired) 


' deciduous) 


deciduous) 
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perm-wired) 


perm-wired) 


oo 
€ 
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@ COLLECTION TWO 


I THE UNWIRED PORTION OF THE SUPERVISOR 


I READ IN BY COLLECTION ONE, DIRECTLY 
SEGMENTS IN THE HARDCORE PARTITIONS 


105 >stl>active_all_rings_data 
Miscellaneous data shared between 
supervisor and the outer rings. 


106 active_hardeore_data 


INTO PAGED 


(ring 


Unwired 


(ring 


Miscellaneous data used by the unwired portion of 
the supervisor: system-wide locks, size constants 


for directory control, system search rule 


metering for directory control and 
linker. 


107 >sll>admin_gate_ 
110 ast_lock_meter_seg 


info, and 
dynamic 


(ring 
(ring 


A segment used to collect AST lock metering, 
normally off (enabled by the ast_lock_metering 


tuning parameter) . 


111 >sll>audit_gate_ 
112 bound_355_wired 

113 bound _file_ system 
114 bound_he_backup 

115 bound_he_recanfig 
‘| bound_he_tuning 

117 bound_imp_dim_ 

120 bound_imp_status 
121 bound_io_active 

122 bound _mes_uti] 

123 bound_priv_mpx 

124 bound_networkO_ 

125 bound_priv_procs 
126 bound_process_creation 
127 bound_salvager 

130 bound scavenger 

131 >sll>bound_sss_active_ 
132 bound _system_faults 
133 bound_tty_active 
134 bound vtoc_man 

135 bounc_x25_mpx 
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(ring 
(ring 
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0) 


0, 


0) 


QO, 


0, 


136 dbm_seg (ring 
The segment used to hoid the dumper bit maps for 
volumes being volume-dumped. The bitmaps are read 
from the volume header when a dump begins, and 
written back when finished. 

137. dirlockt_seg (ring 

The segment used to ‘keep track of all directory 
locks. Directory locks are kept in a supervisor 
segment, rather than in directories themselves. 

140 >sll>dm_hes_ (ring 

141 >sll>dm_journal_seg_ (ring 

re a 7 ae ana ae o | ris 

. Segment ceed for daca eehlecing: by FNP “dump and 
“patch ‘operations (but not peat eadle 

1Lh hasp_mpx (ring 

145 >sli>he_backup_ es (ring 

146 >sll>hes_ (ring 

1h7 >sli>nhphes_ — = (ring 

150 ibm3270_mpx {ring 

151 imp_data (ring 

152. imp_dim_buf_ (ring 

153 imp_tables : . (ring 

154 imp_wired_buffers (ring 
These four segments were used by the ring zero !MP 
CIM (part of the ARPAnet support), which has since’ 
been decomissioned. 

155 initializer_abs_seg (ring 
An abs-seg used solely in order to copy 2 process’s 
stack_0 segment into its process directory on 
process termination. 

156 >sli>initiaiizer_gate_ . “ring 

157 io_page_tabdles (ring 
The segment which contains page tables .used for 1/0 
if the |IOM is operating in Paged mode. It is 
initialized-by ioi_init and used only for ioi_ 1/0. 

160 ioat . (ring 

- - The 1/0 attach table. This is a largely obsolete 
database, the relic of an earlier 1/0 device 
attachment scheme. It is mow used only for loading 
and dumping FNPs. 

161 >sll>ioi_ . (ring 

62 [pd]>kst_seg . (ring 
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The Known Segment Table. Described in Name 6& 
Address Space Management. 


163 Ivt (ring Q) 
The Logical Volume Table. Described in Volume 
Management. 

164 >sll>mhes_ (ring 0, 

165 nmep_tables_ (ring 0) 
Another part of the now-decommissioned ring 2ero 
ARPAnet support, no longer used. 

166 >sll>net_ringO_admin_ (ring 0, 

167 >sll>net_ringO_sys_ (ring 0, 

170 >sll>net_ringO_user_ (ring 0, 

oe LPL PSAP pReS 8 ee a ae wee te Boye a _(ring 0, 

172 polled_vip_mpx |. ae a (ring 0) 

173 pv_salv_seg - Ph. aie at ee Nesom (ring 0) 
This data segment is created in order to run the 
physical volume salvager (now rarely used). It 
contains various databases used by the salvager. It 
is created (by calling grab_aste.pl1) and destroyed 
for each. volume salvage, im each process running a 
salvage, rather than being a shared segment. 

174 salv_abs_seg_00 | (ring 0, 

175 salv_abs_seg_01 (ring 0, 

176 salv_aps_seg 02 _ (ring 0, 

177 salv_abs_seg_03 (ring 0, 

200 salv_abs_seg 04 . (ring 0, 
These five segments are used to overlay the VTOC of 
a volume being salvaged, and are set up and 
referenced by vm_vio.pll. Covered under File System 
Salvagers. 

201 salv_dir_space ~ (ring 0) 

202 salv_data (ring 0) 

203 salyv_temp_dir : (ring 0) 
These three segments are used by the directory 
salvager when invoked as the online salvager, in 
response to a crawlout or bad_dir_ condition. Only 
one instance of the. online salvager may be running 
at a time, and this is ensured by a lock on 
salv_data. The online salvager does not interfere 
with demand directory salvages, however. Covered 
under File System Salvagers. ) 

204 scavenger_data (ring 0) 
The segment containing the tables used when running 
the online volume scavenger. As many volumes as 
tables can be fit nere may be scavenged at one time. 
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> logging daemon. They’ are filled. in whem the daemon 


212 
213 
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215 


216 
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220 
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The in-use portion of the segment is wired while a 
scavenge is being done. Covered under File System 
Saivagers. 


>sll>shes_ (ring 

str_seg (ring 
The segment trailer segment. The trailers in this 
segment record which processes have an SOW for: any 
particular non-supervisor segment, and the 
backup_abs_seg (see above). Covered under Segment 
Control. 


syserr_daemon_dseg _ fring 


_syserr_daemon.pds | tetas 
syserr_daemon_stack> 3°." Bo thn 2 haha, 2 


The. DSEG, POS, ‘and ring zero stack . of the syserr 


Oring. 


0) 


0) 


0). 


processs ‘(which runs entirely in ring zero) is ~ 


created. They are in the global system address 
space primarily for debugging and recordkeeping 
purposes. 


>sll>system_privilege_ - (ring 
>sll>tandd_ : | (ring 
template_pds (ring 
A template for the POS, used when creating a 
process. it is a copy of the pds template which 


came off the system tape, but which was used to 
ereate the Initiaiizer’s PDS. 


tty_area (ring 


An unwired database used by ring zero communications 
system, used primarily for saved metering 


information on each channel. 


tty_buf (ring 
The important segment in_ the ring zero 


0, deciduous) 
0, deciduous) 


0) 


0) 


communications system. Contains the iogical channel | 


table, all communications !/0 buffers, and al] 
multiplexer databases. 


tty_tables ; (ring 
An unwired database used by ring zero communications 
system to keep the tables used for input and output 
translation/conversion. 


vtoc_buffer_seg | | (ring 


‘The segment containing all buffers for VTOC 1/0, and 
a smail amount of controi information. Covered 
under Segment Control. 
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221 <<unused>> 

222 <<unused>> ~ 

223 <<unused>> 

224 <<unused>> 

225 <<unused>> 

226 <<unused>> 

227 <<unused>> 
These segments are unused, since the first segment 
after the supervisor address space is the ring zero 
stack, and its segment number must be zero mod 8. 

230 >slii>stack_0.016 . (ring 
The ring zero stack. OQne is allocated from a pool 
(>s11>stack_0O.NNN) whenever @ process becomes 
eligible. When a process is not eligible (blocked, 
usually), it has no ring zero context, and needs no 
ring zero stack. 

231 [pd]>stack_! | . 3 

232 <<not - used>> 

232 <<not used>> 

234 [pd]>stack_4 . 
The rest of the stacks. There would be others if 
other rings were being used. A stack is created for 
each ring as it is needed; the segment number is 
automatically generated by the CALL6 instruction 
(from D8R.stack), and when a segment fault occurs on 
a stack not yet extant (pdsSstacks(ring) is nuil), 
seg_fault.pll] calls makestack.pll to create one. 
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@ NON-SUPERVISOR SEGMENTS 
I REMAINDER OF A PROCESS ADDRESS SPACE. 


IT BUILT 8Y THE NORMAL NAME AND ADDRESS SPACE MANAGEMENT 
MECHANISMS AS THE PROCESS GETS GOING AND RUNS 


I DIFFERENT IN ee PROCESSES; THIS be ONLY AN 
oo  EXAMPLE © 


eae eg role atten 5 dyoenely 


240 > (the ROOT) 
The ROOT directory. The recursive nature of the 
initiate/segment fault mechanism ensures that this 


will be the first non-supervisor segment in the 
address space. : 


241 >pdd (directory) 
242 >pdd 

243  >sss>bound EPCOGSS? = init. 

244 >udd (directory) 
245 >udd>MED . (directory) 
246 >udd>MED>Sibert (directory) 
247 . [pd]>!BBBMjzKmkengb.area. linker | 

250 >sss (directory) 
251 >unb (directory) 
252 >sil (directory!) 
253 >tools (directory) 
254 >am 2 . (directory) 


255 >sii>bound_sss_active_ 

256 >sll>operator_pointers_ 
257 >sli>bound_sss_wired_ 

260 >s$11>bound_ Process env_ 

261 >sll>hes_ : 

262 [pd]>pit 

263 >sll>bound_error_handlers_ 
264 >s11>bound_ipe_ 

265 >sss>bound_as_requests_ 
266 >sss>bound_info_rtns_ 

267 >scl (directory) 
270 >sel>whotab 

271 >sclinstallation_parms 

272 >sll>sys_info 

273 >sss>bound_command_lcoop_ 


In 
( 

No 

1o 
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274 >scl>command_usage_counts 

275 >scl>command_usage_counts>command_usage_list_ 
276 >scl>command_usage counts>command_usage_totals_ 
277 >sss>bound_exec_com_ 

300 >sll>error_table_ 
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system j|ink meters 


a SYSTEM. LINK_METERS - RECORDS CPU TIME AND PAGING INFORMAT | ON 


DYNAMIC LINKER IN ALL PROCESSES 


Linkage Meters: 


CPU Metering time 4:58:57 
Total time in linker 0:50:53 
Average time per link | 6.01 msec. 
Percentage of real time in linker 17503 . 
Percentage of CPU time in linker ms 4.66 Fs . 
ode slot “Gmsec) ae | Weegee or ae 
Total’ time in Shot. 0:42:03 0:04:16 
Percent total time 82.63 8.40 
Percent total calls 98.06 1.64 
Average time © .. §.06 30.68 


Average page faults 0.18 -2.29 


Segment Search 


Average time - 2.58 25.13 
Average page faults 0.04 . 0.95 
Percent time in slot 57.06 82.58 
Get Linkage 

Average time 0.84 4.08 
Average page faults 0.06 0.62 
Percent time in slot 18.54 13.41 
Definition Search 
Average time 0.24 0.24 
Average page faults 0.02 Oe-b) 
Percent time in slot 5.26 0.80 
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link meters 


@ LINK_METERS - RECORDS CPU TIME AND PAGING INFORMATION USED BY THE 
DYNAMIC LINKER IN THE PROCESS RUNNING IT 


Linkage Meters: “\¢ syak \™ 


slot calls avg time avg pf tot time % time 
<25 1245 4.689 0.3 5.838 76-1 
25-50 34 30.201 2.9 22027 13.4 
50-75 6 62.226 6.2 0.373 4.9 
>75 2 216-545 6.0 0.433 5.6 


Total eps Suge) 0.4 7 671 
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NAME /ADDRESS SPACE COMMANDS 
display kst entry 


@ DISPLAY_KST_ENTRY - DISPLAYS INFORMATION FROM A KST PiicS_ 


{ display_kst_entry >udd>Multics>Sibert 


segno: 
“usage: 
entryp: 
uid: | 
sae 
“modes - 
ex mode: 
“inféount:: 
hdres * 
flags: 


cod 


. 446556324757 


Se iaes a? 


Vas 


246 at 162/270 
7, 0, 0, 0, 0, 0, 0, 0 


[70050 . 


tJ: (0,405.0) =e ay 


quopogeonen 7 IS. mA 
eae Bay tee ese ae 


dirsw write tms 


~ Pins 2 ore Ouml 


eon Vie Soe re 
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TOPIC V 


Directory Control. 


Directory Control Overview . 


Directory Control Terminology. 


Directory Control Data Bases 
_. Directory Segments .. . 


' Directory Header ..... 
. Directory. Entries... . « 


Directory Control Commands 
display branch... . 


© © @ © 6 


e ee. 06°8 ee ® e e 


* ¢ 8 @ *e@© @© @ @ 


.-n se ee oS 


e oe. © ° eo e © e 
oe - 


© 0.8 88 & © « 


‘ 
e 9 e e ‘8 6 e e 


eo t.) © 2 ry ° e e 


e ° ® oe -@ ° e e 


e609 8@ © © #6 @ 


F8OA 


DIRECTORY CONTROL OVERVIEW 


® FUNCTION 


em 


DIRECTORY CONTROL IS A SET OF HARDCORE MODULES RESPONSIBLE FOR 
THE MAINTENANCE OF THE MULTICS DIRECTORY STRUCTURE -- IE: THE 
HIERARCHY 


f «ITS TASKS INCLUDE CREATING, MANIPULATING AND INTERPRETING THE 
CONTENTS OF DIRECTORY Se TO INCLUDE: 


"ACCESS" CONTROL LISTS — “(ACL'S),’ NAMES, AND VTOCE* POINTERS OF 
_ ENTRIES DESCRIBED THEREIN. 


] ONLY DIRECTORY CONTROL IS. ALLOWED TO ALTER THE CONTENTS OF 
DIRECTORY SEGMENTS 


DIRECTORY CONTROL IMPLICITLY RELIES UPON THE SERVICES OF OTHER 
SUBSYSTEMS SUCH AS SEGMENT CONTROL AND PAGE CONTROL, AND ALSO 
INVOKES THEM DIRECTLY BY SUBROUTINE CALL 


] DIRECTORIES ARE SIMPLY SEGMENTS TO THESE SUBSYSTEMS 


| DIRECTORY CONTROL IS INVOKED ONLY BY SUBROUTINE CALLS 


@® PRINCIPAL USER INTERFACES 


f COMMAND LEVEL 
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DIRECTORY CONTROL OVERVIEW 


] create, create_dir, link, set_acl, delete _acl, status, list, 
add_name, rename 


| SUBROUTINE LEVEL 


| hces_Sappend_branch, hes_Sadd_acl_entries, hcs_Sappend_link, 
hes Sdelete_acl_entries, hcs_Sstatus_, hcs_Schname_file 


® MAJOR DATA BASES 
J DIRECTORY SEGMENTS 
] CONTAIN THE ATTRIBUTES AND OTHER INFORMATION ABOUT THEIR 


SEGMENTS (NEEDED TO FIND SEGMENTS, RETURN STATUS INFORMATION, 
AND BUILD VTOCE'S AT SEGMENT CREATION) . 


] SEGMENT WHERE DIRECTORY LOCKING IS MANAGED 
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pre oe Limi? FOS 


Student 01 
seg 1 Prince hw_dir add.pli 


ATT'S] ATT'S ATT'S ATT’'S 


Student 01 


‘fadd.pit 
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DIRECTORY CONTROL TERMINOLOGY 


UNIQUE ID (UID)A 36-BIT ID (SERIAL NUMBER) ASSIGNED TO EVERY SEGMENT 
. WHEN CREATED | 


SON: OF A DIRECTORY. AN IMMEDIATELY INFERIOR (SUBORDINATE) 
SEGMENT 


SON'S LVID: OF A DIRECTORY. THE ID OF THE LOGICAL VOLUME ON WHICH 
ss - . HE DIRECTORY'S SONS RESIDE (AND WILL RESIDE) | 


GRANDSON: OF A DIRECTORY. A SEGMENT INFERIOR BY MORE THAN ONE 
| HIERARCHICAL LEVEL 


~o + Fado t et 4 gece tor a oe vem uve Lal : 
PARENT: OF A SEGMENT. THE “CONTAINING” DIRECTORY SEGMENT 


ANCESTOR: OF A. SEGMENT. THE PARENT, OR GRANDPARENT, OR GREAT 
GRANDPARENT, ETC. 


BROTHER: OF A SEGMENT. ANOTHER SEGMENT HAVING THE SAME PARENT 
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DIRECTORY CONTROL TERMINOLOGY 


BRANCH (1): IN A DIRECTORY. A DATA STRUCTURE, CONTAINED IN A 
DIRECTORY SEGMENT, THAT DESCRIBES AN IMMEDIATELY 
. ., INFERIOR SEGMENT OR DIRECTORY (BUT NOT.A LINK) ; 


BRANCH (2): OF A DIRECTORY. REFERS TO THE ACTUAL SEGMENT OR 
DIRECTORY IMMEDIATELY INFERIOR TO THE DIRECTORY. 


ENTRY (1): | IN A DIRECTORY. SAME AS BRANCH (1) BUT INCLUDES LINKS 


ENTRY (2): | OF A DIRECTORY. SAME AS BRANCH (2) BUT INCLUDES LINKS 


STORAGE SYSTEM TERMINOLOGY 
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DIRECTORY SEGMENTS 
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| 
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¥ 
CREATEPL1 
aa, 


fo) 


DIRECTORY SEGMENT STRUCTURE 
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DIRECTORY CONTROL DATA BASES 


DIRECTORY SEGMENTS 


@ DIRECTORY SEGMENTS ARE DISK RESIDENT (RLV) DATA BASES MAINTAINED BY 
DIRECTORY CONTROL 


] ONE DIRECTORY SEGMENT PER DIRECTORY IN THE HIERARCHY 


"DIRECTORY SEGMENTS CONTAIN. A "CATALOG OF STORAGE SYSTEM INFORMATION | 
“ABOUT ‘OTHER SEGMENTS, DIRECTORIES AND LINKS. 


ALL DIRECTORY SEGMENTS, . BY CONVENTION, RESIDE ON THE ROOT LOGICAL 
VOLUME (RLV) 


DIRECTORY SEGMENTS ac CREATED BY append MUCH LIKE NORMAL SEGMENTS 
ARE CREATED : | 


DIRECTORY SEGMENTS CONTAIN MANY INTER-RELATED © COMPLEX DATA 
STRUCTURES TO INCLUDE THE FOLLOWING (NOT NECESSARILY CONTIGUOUS) 
REGIONS: . 


J) DIRECTORY HEADER 


J CONTAINS SELF DESCRIPTIVE INFORMATION LIKE UID, AIM 
CLASSIFICATION, ETC; AND POINTERS TO OTHER REGIONS 
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DIRECTORY SEGMENTS 


[ HASH TABLE 


J USED TO QUICKLY LOCATE AN ENTRY, GIVEN ITS NAME 


[ ENTRY LIST 


J CONTAINS ONE DESCRIPTIVE DATA STRUCTURE (AN ENTRY) FOR EACH 
SEGMENT, DIRECTORY, OR LINK IMMEDIATELY INFERIOR TO THE 
DIRECTORY (I.E. ALL ENTRIES) . . 


| PERSON_ID AND PROJECT_ID NAME LISTS 


J CONTAINS -ALL PERSON_ID'S/PROJECT_ID'S REQUIRED TO DESCRIBE 
THE ACL, THE AUTHOR, ETC. OF ALL SEGMENTS AND DIRECTORIES 
IMMEDIATELY INFERIOR TO THE DIRECTORY (1.E. ALL BRANCHES) 


[ NAME LIST (ONE PER ENTRY) 
1 CONTAINS ALL NAMES CURRENTLY ASSIGNED TO THE ENTRY 


f PRIMARY NAME IS ACTUALLY CONTAINED IN ENTRY STRUCTURE 
ITSELF 


J ACCESS CONTROL LIST (ONE PER ENTRY) 


i CONTAINS ALL ACL ENTRIES CURRENTLY ASSOCIATED WITH THE ENTRY 
dp ha . dre Cory —OTe Rel, ff 


neoded For aT MGMT 
OVherwise wey peeked. 
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ps 


TYPE OF OBJECT (DIR HEADER = 3) 


APS re ere 


Pender Ae wniter \OCK wae Cys 


DIRECTORY CONTROL DATA BASES 


DIRECTORY HEADER 


7 7 17 tT & 2 2 2 2 2 2~ «2«2« «2«2«3 
§ 6 7 8 @ 61 2 3 3 5 Te Ade 


PROCESS ID OFASTMODIFIER Current pmrodifier 


SIZE OF HEADER (64 WORDS) 


6 WORDS USED BY SALVAGER FOR RECORDING 
DATE TIME CHECKED AND ERRORS DISCOVERED 


8 DIRECTORY’S UNIQUE IDENTIFIER (UID) 


3 OIRECTORY’S PHYSICAL VOLUME !D (PViO} 


10 SONS’ LOGICAL VOLUME !D (LVID) : 


Ww AGCESS ISOLATION MECHANISM {AIM} CLASS 


246 WORDS USED FOR INITIAL ACL IMPLEMENTATION 


12 
_B : | } ownecronys VTOCX . 

pies ENTRY LIST START R_PTR 
1s ENTRY LIST END R_PTR 

16 PERSON _ID LIST START R_PTR 
” 

18 NUMBER OF SEG ENTRIES 

19 

20 ALLOCATION AREA R_PTR 

a5 HASH TABLE SIZE 

46 NUMBER OF USED PLACES IN HASH TABLE 
a7 DEPTH OF THIS DIRECTORY 

a8 
ag 

i) 

62 

63 


(WORDS) 


HASH TABLE R_PTR 


DATE TIME SALVAGED {OTS} 


' UID OF SUPERIOR MASTER DIR 
MODIFICATION PSEUDO-CLOCK: 


12 WOROS UNUSED 


DIRECTORY HEADER 


4 OISK RESIDENT (RLV - DIRECTORY SEGMENT) DATA BASE - ONE PER DIRECTORY 


“COPIED FROM BRANCH WHEN CREATED 


Not To Be Reproduced 


(NOT WIRED. NOT ENCACHEABLE) 


= 


CHECKSUM iNOT USED) 
UIO OF PARENT DIR 


idir _ Meader .inci.pi 1) 


F8OA 


DIRECTORY CONTROL DATA BASES 


DIRECTORY HEADER 


' @ THE DIRECTORY HEADER IS A DISK RESIDENT DATA BASE CONTAINED AT THE 
BEGINNING OF A DIRECTORY SEGMENT 


| ONE DIRECTORY HEADER PER DIRECTORY SEGMENT 


'@ THE DIRECTORY HEADER CONTAINS SELF DESCRIPTIVE INFORMATION SUCH AS: 


“| (THE PROCESS ID OF THE LAST PROCESS TO MODIFY THE DIRECTORY 
SEGMENT'S CONTENTS 


] THE DIRECTORY'S UID, LVID, PVID, VTOC INDEX, AND AIM 
CLASSIFICATION 


[| RELATIVE POINTER 


PERSON. TD List, 


Wg Wh 


‘THE BEGINNING AND END OF THE ENTRY LIST, 
T ™D LIST, AND THE HASH TABLE 


f HIERARCHY DEPTH OF THE DIRECTORY SEGMENT 


f UID OF THE MASTER DIRECTORY AND THE PARENT DIRECTORY 


§ SON'S LVID - THE ID “OF THE LV ON WHICH INFERIOR NON-DIRECTORY 
SEGMENTS RESIDE (AND WILL RESIDE) 


= THE DIRECTORY HEADER IS ACCESSED AT THE BEGINNING OF DIRECTORY 
QUERY AND UPDATE OPERATIONS 
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DIRECTORY CONTROL DATA BASES ieee 


DIRECTORY ENTRIES 


1 1 1 4 1 9 FT 1 1 
9123 485 6 7 €@s @ 123 4 5 6 7 8 8 


0 
1 TYPE OF ENTRY (SEG =7) 
2 , ENTRY'S UNIQUE IOENTIFIER (UID) 


3 OATE TIME ENTRY MODIFIED (DTEM) 
4 NUMBER OF NAMES 
5 NAME LIST START R_PTR NAME LIST ENO R_PTR 


26 ENTRY POINT BOUND 


27 
ACCESS ISOLATION MECHANISM (AIM) CLASS ~ 
om 
2 Ri) RI2) Rt3) | XR?) | XR(2) XR(3) . ACL ENTRY COUNT 


_ 30 ACL START R_PTR ACL END R_PTR 


31 BC AUTHOR'S PERSON _!0 R_PTR BC AUTHOR'S PROJECT _iO R_PTR 
32 3C AUTHOR'S TAG , BIT COUNT {IF DIR, * 0 IMPLIES MSF} 


<i SONS’ (NON-DIR‘S} LOGICAL VOLUME ID (LVIO} 


Not To 


34 
3s 
(WORDS! "Idee entry.inci.pi1) 
BRANCH ENTRY 
. A DISK RESIDENT (RLV — DIRECTORY SEGMENT! OATA BASE ~ ONE PER BRANCH !N DIRECTORY 
{NOT WIRED. NOT ENCACHEABLE) 
Any info wet heer 1S sa Vroce. 
Be Reproduced 5-11 
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268 


DIRECTORY CONTROL DATA BASES 


DIRECTORY ENTRIES 


FORWARD R_PTR BACKWARD R_PTR 


TYPE OF ENTRY (LINK = 5) SIZE OF ENTRY (69 WORDS) 


LINK’S UNIQUE IDENTIFIER (UID) (NEVER VISIBLE TO USERS) 
OATE TIME ENTRY MODIFIED (OTEM) ; 


NUMBER OF NAMES 


NAME LIST START R_PTR : NAME LIST END R_PTR 


AUTHOR'S PROJECT_ID R_PTR 


AUTHOR'S PERSON _ iD R_PTR 


as WORDS CONT. AINING PRIMARY NAME 


| ———$$ $$ 


DATE TIME DUMPED (DTD) 


PATHNAME SIZE 


IDENTICAL TO A DRANCH ENTRY ~~ - -- 


42 WORDS CONTAINING THE ABSOLUTE 
PATHNAME OF THE LINK’S TARGET 


UID CHECKSUM 
| UID OF PARENT DIRECTORY | 
" (WORDS) (dir_fink.met.p1) 
LINK ENTRY 


A DISK RESIDENT (RLV-DIRECTORY SEGMENT) DATA BASE ~ ONE PER LINK IN DIRECTORY 
(NOT WIRED, NOT ENCACHEABLE) 


Reproduced 522 


ny 


DIRECTORY CONTROL DATA BASES 


DIRECTORY ENTRIES 


® THE DIRECTORY ENTRY IS A DISK RESIDENT (RLV) DATA BASE CONTAINED 
WITHIN A DIRECTORY SEGMENT 


f ONE DIRECTORY ENTRY (IN THE DIRECTORY SEGMENT) FOR EACH 
IMMEDIATELY INFERIOR ENTRY IN THE HIERARCHY 


‘g EACH DIRECTORY ENTRY IS A ‘DATA STRUCTURE DESCRIBING THE ATTRIBUTES: 
»s- OF .A SEGMENT, DIRECTORY OR LINK °-.=-.. Gs 


® DIRECTORY ENTRIES COME IN TWO FLAVORS: 


{ LINK ENTRY, (38 OR 72 WORDS) CONTAINING: 


J DATE TIME MODIFIED AND DUMPED (BY THE HIERARCHY DUMPER, NOT 
VOLUME DUMPER) 


f RELATIVE POINTERS TO THE ENTRY'S NAME LIST AND AUTHOR'S USER 
ID , 


J] ABSOLUTE PATHNAME OF THE LINK'S TARGET 


J UID OF PARENT DIRECTORY 
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DIRECTORY CONTROL DATA BASES 


DIRECTORY ENTRIES 


| BRANCH ENTRY, (38 WORDS) CONTAINING: 


DATE TIME MODIFIED AND DUMPED (BY THE HIERARCHY DUMPER, NOT 
VOLUME DUMPER) 


RELATIVE POINTERS TO THE ENTRY'S NAME LIST AND AUTHOR'S USER 


ID 


BRANCH'S UID, PVID, AND VTOC INDEX 


-AIM CLASSIFICATION, ENTRY POINT BOUND, RING BRACKETS, AND 
RELATIVE POINTERS TO THE ACL | 


BRANCH'S BIT COUNT AND BIT COUNT AUTHOR 


SON'S LVID (IF A DIRECTORY) AND PARENT'S UID 


FLAGS DESCRIBING VARIOUS STATES AND PROPERTIES OF THE ENTRY 
SUCH AS: DIRECTORY, MASTER DIRECTORY, SECURITY OUT OF 
SERVICE, COPY AND SAFETY SWITCH, ETC , 
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DIRECTORY CONTROL COMMANDS 
display branch 
@ DISPLAY_BRANCH - DISPLAYS BRANCHES IN THE DIRECTORY HIERARCHY 
\ \ | 
I OFTEN USEFUL ON CONJUNCTION WITH DUMP_VTOCE ai) eee, 


Org Play wrote 


! display_branch >udd>Multies>Sibert 


eranch for Sibert in >udd>Mul ties at 245 | 20742 


I, 


aa vip 102401170050, is vtocx 63 ¢ on | root (of ‘leg vol. root) 
“ff Sibert is a directory. ; 
“f°: Ring brackets (0 0 0). a ee 
. Entry modified 02/23/83 1912.1 est Wed 
Bumped 03/20/83 0955.6 est Sun 
Oo names. 


| s DtSPLAY !S NOT OREEET EY SO A RING ZERO_DUMP OF THE SAME DATA IS 
INCLUDED 

te Lond Coe Ae calry 
/" WOEth > 


-! ring _zero_dump >udd>Multics 20742 46 -ch 


7 | 044 | | 
020742 021310020604 000004000046\102401170050 446556324757 ...--.- Bx (2... 
020746 400000000011 020752021152’ 001720000532 172000000000 ..... ie eens 


020752 021010000000 000006000016 020742000233 000000000000 ................ 
020756 123151142145 162164040040 040040040040 040040040040 Sibert 


020762 040040040040 040040040040 040040040040 040040040040 

020766 000000000000..102401170050 446752147026 000000000000 ....8.x(..g..... 
020772 135240026001 000063000000 400000000000 o00000000000 ]....3.......... 
020776 000000000000 000770000012 021170021300 001720000532 ......... a 


021002 172000000000 225072707470 000000000000 000000000000 z....:.......... 
021006 033023254650 000000000000 = = = = = aaeccces 


Te Bik Gracch oF S CYue_t o lol | 
ie ane oT hey wo ¥. Seu Pd J a a al Can!) T delete 
Pr2 BUF QoTIWYy O 
—s Lid 
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Volume Management 


Volume Management Overview . 
The New Storage System... 


Volume Management Terminology. 


orem doa banat baka Bases 


Volume Label - tg ge ‘eo 


Volume Map . . .... 


oye Dumper Bit. Map sea-ice: 


VTOC Map... . . 


° 


e 
e: 
e 


TOPIC VI 


Physical Volume Table (PVT). 
Logical Volume Table (LVT) 
Physical Volume Hold Table . 


Volume Management Operations 


Acceptance of Physical Volumes 
Demounting of Physical Volumes 


_ Logical Volume Management. 


Volume Management Commands . 
print_configuration_deck 
DUSE VOLS 65 1. a7 6 8 Gi ene 
display lahel. =.=: :- - 
display_pvte a 

Volume Management Meters . 
disk_meters. . . 2... 
device_meters. ... 
disk_queue ...-... 
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VOLUME MANAGEMENT OVERVIEW 


2 FUNCTION 


fj VOLUME MANAGEMENT Is RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 
AND LOGICAL VOLUMES 


f ITS TASKS INCLUDE: 
| ACCEPTANCE AND DEMOUNTING OF PHYSICAL VOLUMES 


-} MAINTAINING THE. ASSOCIATION. BETWEEN | I hie trai VOLUMES. , Sabtyc cies 
" “VOLUMES, AND DISK DRIVES - 


|. ENSURING THE INTEGRITY OF VOLUME CONTENTS | 


- | MAKING VOLUME CONTENTS ACCESSABLE TO PAGE CONTROL (PAGES) AND 
SEGMENT CONTROL (VTOC ENTRIES) 


f VOLUME MANAGEMENT IS INVOKED ONLY BY SUBROUTINE CALLS 
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VOLUME MANAGEMENT OVERVIEW 


® MAJOR DATA BASES 


J PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM 


f PHYSICAL VOLUME TABLE ENTRY (PVTE) - ONE PER DISK DRIVE KNOWN 
TO THE SYSTEM . 


| EACH PVTE IDENTIFIES A DRIVE'’S DEVICE NUMBER, SUBSYSTEM NAME, 
DEVICE TYPE, AND INFORMATION ABOUT THE PHYSICAL VOLUME 
CURRENTLY MOuyTED | y * 


> USED - TO MAP REFERENCES TO PAGES OF SEGMENTS -INTO AN 1/0” 
REQUEST TO THE CORRECT DISK DRIVE 


] LOGICAL VOLUME TABLE (LVT) - ONE PER SYSTEM 


J LOGICAL VOLUME TABLE ENTRY (LVTE) - ONE PER MOUNTED LOGICAL 
VOLUME 

j EACH LVTE CONTAINS THE LOGICAL VOLUME ID, POINTERS TO MEMBER 
PVTE'S, AIM CLASS LIMITS, ETC. 


1 USED TO DETERMINE A USER'S ACCESS TO A LOGICAL VOLUME 
(PRIVATE OR PUBLIC) AND TO LOCATE MEMBER PHYSICAL VOLUMES 


) VOLUME HEADER - ONE PER PACK 
J VOLUME LABEL (REGISTRATION AND ACCEPTANCE INFORMATION) 


J VOLUME MAP (OCCUPIED/VACANT INFORMATION FOR VOLUME CONTENTS ) 
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VOLUME MANAGEMENT OVERVIEW 


f RECORD STOCKS - ONE PER MOUNTED VOLUME 


J Sieg CACHE OF INFORMATION ABOUT USED / UNUSED RECORDS ON 
THE VOLUME 


f THIS INFORMATION IS DERIVED FROM THE VOLUME MAP, BUT KEPT 
ONLINE TO AVOID THE NECESSITY OF REFERRING TO THE VOLUME MAP 
ON DISK EVERY TIME A RECORD IS ALLOCATED OR FREED 


) WHEN THE CACHE BECOMES COMPLETELY EMPTY OR COMPLETELY FULL, 
-., IT MUST BE UPDATED FROM/TO DISK - A PROTOCOL ENSURES THAT THE 
COPY ON DISK IS ALWAYS CONSISTENT 


J PROVIDED BY VOLUME MANAGEMENT, BUT USED BY PAGE CONTROL 


|| VTOCE STOCKS - ONE PER VOLUME 


at T mA DPELABNH emnr Prtrr ATRAIMA TAS TMEA RMTARY ADATIM 
IMILAR iV Vw OL S; aU MAT} o #34 IND INFORMATION ABOUT 


USED / UNUSED VTOC ENTRIES ON THE VOLUME 


) PROVIDED BY VOLUME MANAGEMENT, BUT USED BY SEGMENT CONTROL 


f PHYSICAL VOLUME HOLD TABLE (PVHT) - ONE PER SISTEM 


i RECORDS THE COMMENCEMENT OF COMPOUND ‘1/0 OPERATIONS UPON A 
PHYSICAL VOLUME 


f THIS INFORMATION PREVENTS A VOLUME FROM BEING DEMOUNTED WHILE 
SUCH AN OPERATION IS IN PROGRESS 


Not To Be Reproduced e=3 FSOA 


ION 


> 


peonpordsy eg oo; 


YOgd 


THE NEW STORAGE SYSTEM 


* LOGICAL VOLUME B 


LOGICAL VOLUME A 


PV pub @1 PV pub @2 


PVrpv . . PV root 2 PV root 3 


at KARAARAAAAA TCO ROS COPHECCVECCEEED ORE e,- ; eee RKO OO Ps. ATTN) RN eure 
RTI VNTR PETITE OOO SOOO ate KKK KKK PTR KOKORO KOO 
KKK ROR KX KAARXXX KKK REARS NO aretatatatatatolatatlatacececacncecerececertcace.: IRA KEK RRA AKO OAL CO rtatitllcerienitns 
RRR K KKK RK Lk ROR EARN od SNAtataratatatatatatetarareetatatatetat-t a LYRA ALK bao RRR RXRR Roa 


HEADER | 


PAGING 
REGION 


LOW PARTITION 


PAGING 
REGION 


PAGING 
REGION 


PARTITION HIGH PARTITION 


PHYSICAL VOLUME (PV): A DISK PACK 


LOGICAL VOLUME (LV): A COLLECTION OF ONE OR MORE PHYSICAL 
; VOLUMES GIVEN A SINGLE LOGICAL IDENTITY 


VOLUME HEADER: CONTAINS THE LABEL, VOLUME MAP, VTOC 
| MAP, AND VOLUME DUMP MAPS. 


VOLUME TABLE OF CONTENTS (VTOC): AN ARRAY OF ENTRIES (VTOCE’s) DESCRIBING 
EACH SEGMENT ON THE PHYSICAL VOLUME 


PAGING REGION: THE REGION IN WHICH ALL RECORDS DESCRIBED 

, ‘IN THE VTOC RESIDE (1.E., PAGES OF STORAGE 
SYSTEM SEGMENTS) | 

PARTITION: A REGION SET ASIDE FOR SOME PURPOSE OTHER 


THAN PAGES OF STORAGE SYSTEM SEGMENTS 


WHLSAS ZOVUOLS MAN SHL 


THE NEW STORAGE SYSTEM 


-@ SINCE RELEASE 4.0, THE MULTICS STORAGE SYSTEM HAS BEEN ORGANI ZED 
INTO PHYSICAL AND LOGICAL VOLUMES HAVING THE FOLLOWING PROPERTIES 


on acd ware address fale Uniy. 1e@ Boos 


] A PHYSICAL VOLUME (PV) IS A DISK PACK (MOUNTED OR NOT) 
' CONTAINING: | | 


f A LABEL IDENTIFYING ITSELF - INCLUDING A PHYSICAL VOLUME ID 
(PVID) 


f:. -A VOLUME .MAP DESCRIBING WHICH PAGES and VTOCES ARE IN USE .AND. 
“WHICH ARE FREE. 


j A VOLUME TABLE OF CONTENTS (VTOC) DESCRIBING WHICH SEGMENTS © 
ARE RESIDENT THEREIN - AND THE EXACT LOCATION OF EACH OF 
THEIR PAGES } 


| THE PAGES OF RESIDENT SEGMENTS (ASSIGNED TO RECORDS OF 1024 
-- WORDS IN SIZE) | 


| AND OPTIONALLY: CONTIGUOUS REGIONS CALLED PARTITIONS, SET ~ 
ASIDE FOR SPECIAL USE (FDUMP IMAGES, HARDCORE PAGING, ETC) 


J ALL PAGES OF A SEGMENT RESIDE ON A GIVEN PHYSICAL VOLUME 


[ THAT IS: EACH NON-ZERO PAGE OF A SEGMENT IS ASSIGNED TO A 
RECORD OF THE PHYSICAL VOLUME 


] THE PAIR. OF PHYSICAL VOLUME ID (PVID) AND vTOC INDEX UNIQUELY 
IDENTIFIES ANY SEGMENT IN THE STORAGE SYSTEM HIERARCHY 


MSU Goo 


ns 0 
| Lf ay FET 
A 


ceCSes 
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Not 


THE NEW STORAGE SYSTEM 
A LOGICAL VOLUME (LV) CONSISTS OF ONE OR MORE PHYSICAL VOLUMES, 
WHICH ARE: 
. GIVEN ONE LOGICAL VOLUME ID (LVID) 


J ALWAYS MOUNTED AS A SET 


OFFSPRING (SONS, GRANDSONS, ETC) OF A DIRECTORY (NORMALLY) 
RESIDE WITHIN A GIVEN LOGICAL VOLUME 


§ IN OTHER WORDS, aR SUB- “TREE re oe NO MORE THAN ONE 


LOGICAL VOLUME | 


DIRECTORY SEGMENTS ARE AN EXCEPTION TO THE ABOVE AS ALL 
DIRECTORY SEGMENTS ARE ASSIGNED TO A LOGICAL VOLUME OF THEIR OWN 
CALLED THE "ROOT LOGICAL VOLUME” (RLV) 


f THE PHYSICAL VOLUME CONTAINING THE ROOT DIRECTORY IS CALLED 
"THE ROOT PHYSICAL VOLUME” (RPV) 


. THE RLV IS SPECIAL BECAUSE IT MUST ALWAYS BE MOUNTED, AND IT 
CONTAINS ALL DIRECTORY SEGMENTS, BUT IT ALSO CONTAINS OTHER 
SEGMENTS 


SHOULD THE GROWING OF A SEGMENT CAUSE A PHYSICAL VOLUME TO 
BECOME FULL, A “SEGMENT MOVE" IS AUTOMATICALLY INITIATED 


J. THIS IS ONE OF THE MOST COMPLEX AND EXPENSIVE SERVICES 
PERFORMED BY THE SYSTEM - BUT HAPPENS VERY INFREQUENTLY 
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THE NEW STORAGE SYSTEM 


1 SHOULD A LOGICAL VOLUME BECOME FULL: 
) USER. AND SYSTEM ERROR MESSAGES ARE GENERATED 


SPACE MUST BE OBTAINED ON THE LOGICAL VOLUME BY ADDING MORE 
PHYSICAL VOLUMES OR BY DELETING OR MOVING SEGMENTS FROM THE 
LOGI CAL VOLUME | 


|. BECAUSE IT CONTAINS ALL DIRECTORY SEGMENTS, SPACE ON THE RLV 
IS CRITICAL: IF IT IS USED UP, THE SYSTEM MAY NOT BE ABLE TO 
CONTINUE, OPERATION ..:: 


. THE CHOICE OF WHICH PHYSICAL VOLUME TO USE WHEN CREATING A 
SEGMENT IS MADE IN SUCH A WAY AS TO TRY TO BALANCE THE ALLOCATED 
SPACE ON ALL THE PHYSICAL VOLUMES OF A LOGICAL VOLUME 


ket Bercy) An G) Pie |S) 
Ke€ Nan Q § eo a Kee | . VV) 
Yio | 
kOTR (Sey e) Seo) . Ver Vian @ ; Name ; ; AST. 


ST uy > Raley 


rina? ~ a VT Of o cedeaT 
Rigor rs qian 
Nan Bel ol NemVICL J VTOCR Pc RDS 
& 


Mor \; : 

Lehen Aled MAP aN ae 
aul Vea 8 & ; g Pade Gu 
jem] rec alg a aaa 


C Ounter Aut IVTE a | aoe f . Fa Team 2 
; Ow \ 

F fee 

teCords, 
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THE NEW STORAGE SYSTEM 


VOLUME MAP 
(USED RECORDS MAP) 


VOLUME 


REGION sane vToc aan HEADER ———» 


_ VTOC HEADER AND 
- DUMPER BIT MAP 


| VTOCE’s 
(ONE PER RESIDENT SEGMENT: =~ 15,000 VTOCE’S) 
(FIVE PER RECORD: = 3,000 RECORDS) 


L Pw 
PAGES OF SEGMENTS 
(ONE PER RECORD: ~ 35,000 RECORDS) ¥f 


PAGING 


PARTITIONS (IF ANY) 
(SPECIAL-USE REGIONS... SUCH AS FDUMP IMAGES) 


38,247 


(RECORDS) _ (disk_pack.incl.p!1) 


PHYSICAL VOLUME FORMAT 


(MSU 451) 
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~~ PARTITIONS + 


| VOLUME LABEL aa 
(REGISTRATION INFORMATION) 
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THE NEW STORAGE SYSTEM 


_ HIERARCHY TO bediciecas SYSTEM 
* MAPPING - 


| 


HEADER INFO 7 HEADER INFO 


PHYSICAL VOLUME ID 14 
CONTENTS (SIMPLIFIED) 


PHYSICAL VOLUME ID 29 


J vdd EU Re 5 WT : — CONTENTS (SIMPLIFIED) 
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THE NEW STORAGE SYSTEM 


@ IF ONE KNOWS WHERE THE ROOT DIRECTORY IS, ALL SEGMENTS IN THE 
MULTICS HIERARCHY CAN BE SOEND (ASSUMING THE AVAILABILITY OF ALL 
REQUIRED. PHYSICAL VOLUMES ) 


= MAJOR DESIGN POINT 


J . MANY: DISK RESIDENT DATA BASES (TO INCLUDE THE PAGES OF SEGMENTS) 
ARE COPIED INTO MAIN MEMORY AND WRITTEN BACK TO DISK AT SUCH 
“TIMES AS: ° 


> SYSTEM START-UP /SHUT-DOWN 
] PHYSICAL VOLUME MOUNTING /DEMOUNTING 
| SEGMENT ACTIVATION/DEACTIVATION 


| PAGE FAULTS 


) WHILE IN MAIN MEMORY, THE MEMORY RESIDENT COPY IS CONSIDERED TO 
BE THE COPY 


] WHILE IN MAIN MEMORY, THE DISK RESIDENT COPY IS CONSIDERED TO BE 
(AND OFTEN el WHOLLY INVALID 
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THE NEW STORAGE SYSTEM 


a 
Q 
o uw fm x §8 
nal ro) morc © < x 
© o oe = > < 
oe mess 
TRACKS 


CYLINDERS 


MULTICS DISK PACK STATISTICS (MSU 451) 


* THE ABOVE FIGURES APPEAR INCONSISTENT IF 
DATA FORMATTING IS NOT CONSIDERED 
(E.G.: SOME DISK SPACE IS NOT USED) 


| €S_deyin yPes incl OL 4 
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LOGICAL VOLUME/MASTER DIRECTORY RELATIONSHIP 


* NOTE: ALL DIRECTORY SEGMENTS RESIDE ON ONE DESIGNATED ; 
LOGICAL VOLUME CALLED THE ROOT LOGICAL VOLUME (RLV) 


WELSAS SZDVHOLS MEN FHL 


MOUNT: 


ACCEPT: 


“PUBLIC: 


PRIVATE: 


PARTITION: 


RECORD: 


SECTOR: 


VOLUME MANAGEMENT TERMINOLOGY 


TO PHYSICALLY PLACE A DISK PACK ON A DRIVE AND CYCLE UP 
THE DRIVE. (PERFORMED BY THE OPERATOR, NOT BY 


‘SOFTWARE ) 


AFTER MOUNTING, TO ESTABLISH IN THE SUPERVISOR THE 
BINDING BETWEEN THE DRIVE AND THE PHYSICAL VOLUME 
MOUNTED 


‘K LOGICAL. VOLUME ATTRIBUTE INDICATING THAT THE VOLUME 


IS ATTACHED TO ALL PROCESSES (BY DEFAULT) WHEN ACCEPTED 


; 


A LOGICAL VOLUME ATTRIBUTE INDICATING THAT THE VOLUME 
S SUB = om 


IS ATTACHED ONLY TO REQUESTING PROCESSES 


ACCESS CONTROES 


A REGION WITHIN A PHYSICAL VOLUME SET ASIDE FOR SPECIAL 
USE 


A LOGICAL UNIT OF DISK SPACE, 1024 CONTIGUOUS WORDS IN- 
SIZE... (NUMBERED/ADDRESSED FROM ZERO) 


hoes With Page Frame “bsuh cs Ke@? tn Hin a ngs ¥ : 


A poe UNIT OF DISK SPACE, 64 CONTIGUOUS WORDS IN 


SIZE. MALLEST ADDRESSABLE UNIT OF DISK SPACE. A 
RECORD CONTAINS 16 SECTO 
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VOLUME MANAGEMENT TERMINOLOGY 


PAGE: A 1024 WORD EXTENT OF DATA STARTING AT A 1024 WORD 
BOUNDARY OF A SEGMENT. SEGMENTS MUST BE AN INTEGER 
NUMBER OF PAGES IN SIZE. A PAGE CAN RESIDE IN ONE OR 
MORE OF THE FOLLOWING LOCATIONS: 
MAIN MEMORY FRAME 


DISK RECORD 
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VOLUME MANAGEMENT DATA BASES 


VOLUME LABEL 


‘ 7 1 1°97 «234 «+4 *t 4 2 
2345 67289 031 23 45 6 7 8 8 8 


320 WORDS (5 SECTORS) NOT USED (GCOS LABEL REGION} 


SWORDS: “Muttics Storage System Volume“ 


BF eee rae 8 WORDS CONTAINING MANUFACTURE'S SERIAL NUMER” 


nae ;- SWORDS CONTAINING PHYSICAL VOLUME NAME. 
"" 8 WORDS CONTAINING LOGICAL VOLUME NAME 


PHYSICAL VOLUME IDENTIFIER (PVID} 


LOGICAL VOLUME IDENTIFIER (LVID) 


PVID OF THE ROOT PHYSICAL VOLUME 


TIME REGISTERED 


MAXIMUM AIM CLASSIFICATION IN VOLUME 


MINIMUM AIM CLASSIFICATION IN VOLUME 


18 WORDS NOT USED 


Tyme wal Oder 


“Prme - Rey 
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VOLUME MANAGEMENT DATA BASES 


VOLUME LABEL 


ae ad 


6-0 VOLMAP VERSION (OVERLAYS OLD TIME—-UNMOUNTED) 


TIME SALVAGED 


6s TIME OF BOOTLOAD ; 
ee | TIME UNMOUNTED | 


8 WORDS USED BY VOLUME DUMPER 


=—- DYNAMIC INFORMATION - 


48 WORDS UNUSED 
7-0 T 
74 
7-2 
7-30~O«*#€§ a3 ae Sennett 
74 aa DISK_TABLE_ VTOC INDEX 
1 | Z ".. _BISK_TABLE. UNIQUE ID 
78. ESD STATE 
1-7 "VOLUME MAP ORIGIN RECORD : 
2:8 


Wo ae INE ed 
m1 
se 
Ms 


52 WORDS UNUSED 


7-9 =. VTOC MAP ORIGIN RECORD | 
1 


--—= HOOT INFORMATION AND VOLUME DESCRIPTION — 


NUMBER OF PARTITIONS 


8-3 
v 
—— 
4 PARTITION (1) NAME 
5 PARTITION (1) LOCATION 
. : z 
‘ PARTITION (1) SIZE = > 
== 
< 
? Se 
188 WORDS DESCRIBING PARTITIONS 2 THRU 47 
. - 
& 
1=-90 
320 WORDS (5 SECTORS) NOT USED = = 
, 23 
__ 3-683 | | = | , 


(SECTOR~WORD) (fs_ voi _labei.snct.pf1) 


VOLUME LABEL 


A DISK RESIDENT DATA BASE — ONE PER PHYSICAL VOLUME 
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VOLUME MANAGEMENT DATA BASES 


VOLUME LABEL 


® THE VOLUME LABEL IS A DISK RESIDENT DATA BASE OCCUPYING THE FIRST 
MULTICS RECORD OF EACH STORAGE SYSTEM PHYSICAL VOLUME 


f ONE VOLUME LABEL PER PHYSICAL VOLUME 


® THE LABEL IS. GENERATED BY init _disk _pack (init_empty_root IF RPV. 
_ LABEL) AND CONTAINS REGISTRATION | AND STATUS INFORMATION 


1 


@ THE LABEL IS INSPECTED WHEN THE VOLUME IS ACCEPTED AND UPDATED WHEN 
DEMOUNTED . 


® THE LABEL IS DIVIDED-INTO SIX SECTORS 


-] GCOS REGION (SECTORS 0 TO 4) 


] SKIPPED OVER BY MULTICS TO AVOID ACCIDENTAL OVERWRITING OF 
GCOS PACKS AND ALLOW FOR FUTURE COMPATABILITY 


] PERMANENT REGION (SECTOR 5) 


f CONTAINS PERMANENT PER-PV INFORMATION (EG: MANUFACTURERS 
SERIAL NUMBER) ie 
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VOLUME MANAGEMENT DATA BASES 


VOLUME LABEL 


J DYNAMIC INFORMATION REGION (SECTOR 6) 


§ CONTAINS INFORMATION RELATING TO THE MOST RECENT MOUNTING OF 
THE PV (EG: LAST MOUNT TIME) 


J ALLOWS THE STORAGE SYSTEM TO ENSURE THE INTEGRITY OF THE PV 


{ - ROOT INFORMATION REGION (SECTOR 7) 
| . DEFINED ONLY. FOR THE ROOT PHYSICAL VOLUME. 


f CONTAINS DYNAMIC INFORMATION ABOUT THE ENTIRE STORAGE SYSTEM 
-(EG:. SHUT DOWN STATE, PAGING DEVICE STATE, ETC) | 


) PARTITION MAP (SECTOR 8) 


f IDENTIFIES THE LOCATION AND LENGTH OF ANY RESIDENT PARTITIONS | 


| UNUSED (SECTORS 9 TO 13) 
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VOLUME MANAGEMENT DATA BASES 


VOLUME MAP 


13% 7 7 7 «47 7 4 47 «4 2 222 2 «22 22 «2«3« «3 «3 «3 «3 «3 
123 4 5 6 7 8 §$ Ot 23 4 5 6 7 8 = €t2345 6 7 8 $ Ot 23 4 § 
SIZE OF PAGING REGION is 
LOCATION OF PAGING REGION . ae 
. NUMBER OF VACANT RECORDS ~ PA 
2 < = 
SIZE OF BIT MAP ae Eas Ch ae Gia ne nee = = 
60 WORDS NOT USED | 
17-0 fe BIT MAP OF FIRST 32 RECORDS 
1 Be BIT MAP OF SECOND 32 RECORDS 
rid 
e e < 
: = 
eee ee 
63 — 63 Be! BIT MAP OF 3008th 32 RECORDS 
(SECTOR - WORD) : __ {fs_vol__map.inei.pi1) 


A DISK RESIDENT DATA BASE ~ ONE PER PHYSICAL VOLUME 
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VOLUME MANAGEMENT DATA BASES 


VOLUME MAP 


® THE VOLUME MAP IS A DISK RESIDENT DATA BASE 


{ OCCUPIES RECORDS 1, 2, AND 3, IMMEDIATELY FOLLOWING THE VOLUME 
LABEL 


) ONE VOLUME MAP PER PHYSICAL VOLUME 


@ THE VOLUME MAP IDENTIFIES THE EXTENT OF THE PAGING REGION, THE 
NUMBER OF VACANT RECORDS, AND THE STATE (VACANT/OCCUPIED) OF EVERY 
RECORD IN THE VOLUME!'S PAGING REGION 


1 THIS INFORMATION IS ALSO DERIVABLE FROM AN ANALYSIS OF THE VTOC 
(AT CONSIDERABLE EXPENSE) - THIS IS DONE WHEN THE VOLUME IS 
SCAVENGED OR SALVAGED. 


@ RECORDS ARE TAKEN FROM THE VOLUME MAP DURING OPERATION AND PLACED 
IN THE RECORD STOCK 
een 


J RECORDS ARE ALLOCATED BY PAGE CONTROL FROM THE RECORD STOCK 
{| VOLUME MAP ON DISK IS “ALWAYS CONSISTENT 


fj RECORDS MARKED FREE ON DISK ARE GUARANTEED TO BE FREE, AND 
SAFE TO RE-USE 
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VOLUME MANAGEMENT DATA BASES 


VOLUME MAP 


never CeVvEerse 


J RECORDS MARKED AS ALLOCATED MAY NOT ACTUALLY BE IN-USE, IF A. 
CRASH OCCURRED AND DESTROYED THE STOCK CONTENTS 


| THIS SITUATION IS BENIGN, AND CORRECTED BY A. SCAVENGE OR 
SALVAGE AT SOME CONVENIENT TIME 
| RECORDS FREED ARE PLACED BACK IN THE STOCK 
‘|. IF STOCK FILLS, IT IS WRITTEN BACK TO THE VOLUME MAP 
| CONSISTENCY IS ENSURED BY COMPLEX PROTOCOL IN PAGE CONTROL 


f RECORD STOCK MECHANISM REPLACES FSMAP SEGMENTS IN PRE-MR10.0 
SYSTEMS . _* 
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VOLUME MANAGEMENT DATA BASES 


DUMPER BIT MAP 


NUMBER OF FREE VTOCES 


NUMBER OF WORDS USED IN BIT MAP 


NUMBER OF LAST RECORD IN VTOC 


ee ee . ,4WORDSUNUSED 


NUMBER OF VTOCES { 


af... VTOC BIT MAP ENTRY 0 


1023 | a VTOC BIT MAP ENTRY 1015. 


VOLUME DUMPER BIT MAP 
RECORDS 4 AND5 


8 WORDS UNUSED 


sf VOLUME DUMPER BIT MAP ENTRY 0 


2047 7 VOLUME DUMPER BIT MAP ENTRY 2039 


VTOC MAP 


RECORD 6 
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VOLUME MANAGEMENT DATA BASES 


DUMPER BIT MAP 


@ THE DUMPER BIT MAP DESCRIBES WHICH VTOCES ON THE VOLUME HAVE BEEN 
VOLUME DUMPED : 


) ONE PER PHYSICAL VOLUME 
J OCCUPIES RECORDS 4. AND 5, IMMEDIATELY FOLLOWING VOLUME MAP 


|. SEPARATE BIT MAPS FOR INCREMENTAL AND CONSOLIDATED VOLUME DUMPS 
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VOLUME MANAGEMENT DATA BASES 


VTOC MAP 


THE VTOC MAP DESCRIBES THE LOCATION AND SIZE OF THE TOC, AND 
CONTAINS A BIT MAP OF VTOC ALLOCATIONS . 


] OCCUPIES RECORD 6, IMMEDIATELY FOLLOWING THE DUMPER BIT MAP 


{ VTOC FOLLOWS, STARTING AT RECORD 8 


| RECORD 7 IS UNUSED 


& VTOCES ARE TAKEN FROM THE VTOCE MAP AND PLACED IN AN ONLINE STOCK 


§ VTOCE STOCK IS LIKE RECORD STOCK, BUT LESS CRITICAL 


VTOCES ARE SELF-IDENTIFYING AS TO WHETHER THEY ARE IN USE OR 
NOT, SO IT IS NOT NECESSARY TO MAINTAIN PERFECT CONSISTENCY 
IF A CRASH OCCURS . 


VTOCE MAP IS ALSO REBUILT BY SCAVENGE OR SALVAGE OPERATIONS 


f VTOCE MAP REPLACES VTOCE FREE LIST IN PRE-MRi0.0 SYSTEMS 
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VOLUME MANAGEMENT DATA BASES 


NUMBER OF ENTRIES 
MAXIMUM NUMBER OF ENTRIES 
NUMBER OF ENTRIES IN USE 


5 WORDS FOR SHUTDOWN STATUS 


ne ee ee _ SWORDS OF INFORMATION ABOUT RPV ANDALV 


“19 eb ee a ee 21 WORDS OF GLOBAL INFORMATION AND 
te are _» METERING CELLS FOR VOLUME MAPS 
7 AND VTOC Maps. 


_ ARRAY OF PHYSICAL VOLUME TABLE ENTRIES 


PHYSICAL VOLUME TABLE ENTRY (PVTE) 


ONE PER PHYSICAL VOLUME 
LOCATED IN PHYSICAL VOLUME TABLE 


\ se 6 | | PHYSICAL VOLUME ID 


: +" ; 
3 2 DISK SUBSYSTEM NAME | - ACR a. 
, aero | omen ETRE 
, 
. 
7 FREE RECORD COUNT _ TOTAL RECORD COUNT 

. 


10 COMP. OQUMPER VTOC INDEX TOTAL VTOCE COUNT 


N 
Ter 


Vv 
a 
¢ 


cor 


vj 
4 ! 
N| 


FIRST RECORD IN PAGING REGION 


9 _—— eee FOR VOLUME MAP AND VTOC MAP INFORMATION 


22 VOLUME TROUBLE COUNT SCAVENGER INFO POINTER 


1 OF PHYSICAL VOLUME TABLE HEADER 
ane stent A HARDCORE (WIRED) DATABASE - ONE PER SYSTEM 
\ac | 
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VOLUME MANAGEMENT DATA BASES 


PHYSICAL VOLUME TABLE (PVT) 


® THE PHYSICAL VOLUME TABLE (PVT) IS A HARDCORE, WIRED, PAGED DATA 
BASE MAINTAINED BY VOLUME MANAGEMENT 


) ONE PVT PER SYSTEM 


® THE PVT IS THE MOST IMPORTANT DATA BASE OF VOLUME MANAGEMENT, AND 
- .. CONTAINS AN ARRAY OF PHYSICAL VOLUME TABLE ENTRIES (PVTE'S) 


J ONE PVTE PER DISK DRIVE KNOWN TO THE SYSTEM 


@® EACH PVTE DESCRIBES: 


f A DISK DRIVE CONFIGURED TO THE SYSTEM 


J INCLUDING THE DEVICE NUMBER, DEVICE TYPE, SUBSYSTEM NAME AND 
OTHER INFORMATION NEEDED BY THE DISK DIM 


] THE PHYSICAL VOLUME CURRENTLY MOUNTED ON THE DISK DRIVE 


J INCLUDING THE PVID, LVID, AND OTHER INFORMATION TAKEN FROM 
THE VOLUME HEADER, VOLUME MAP AND VTOC MAP, NEEDED BY PAGE 
AND SEGMENT CONTROL (THE PV & LV NAMES ARE NOT RECORDED HERE) 


f RECORD AND VTOCE STOCKS ARE LOCATED FROM THE PVT, BUT KEPT IN. 
THE stock_seg 
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VOLUME MANAGEMENT DATA BASES 


LOGICAL VOLUME TABLE (LVT) 


i174 q iizg#22222.222233 «3 33 «~3 
4 ee a ee eee $9301 23 45 6 7 8 $$ O12 3 @ § 
h) MAX LVTE INDEX a 
1 HIGH WATER LVTE INDEX ee 
2 
FIRST FREE LVTE POINTER 
3 & 
[= 
F : , < 
ig wie heck P ORB ay , Ce oem (ee 4 WORDS a Ns “ , 2 Fe : : Lng 
ogee Bee “"-. "  @AWORDS OF LVTE POINTERS USED a 3 - 
AS A HASH TABLE 
o- POINTER TO NEXT LVTE 
4 
2 LOGICAL VOLUME ID (LVID) 
3 __ MINIMUM AIM CLASSIFICATION i 
IN LOGICAL VOLUME 2 
— 
é e 
= 
5 
MAXIMUM AIM CLASSIFICATION 
IN LOGICAL VOLUME 
; , 
7 : ALLOCATION ALGORITHM VALUE 


OTHER LVTE's 
ONE PER MOUNTED LOGICAL VOLUME 


| (WORDS) io (lvt. inel.pit) 


LOGICAL VOLUME TABLE (LVT) 


A HAROCORE DATA BASE — ONE PER SYSTEM 


LOGICAL VOLUME TABLE ENTRY (LVTE) 


ONE PER MOUNTED LOGICAL VOLUME 
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VOLUME MANAGEMENT DATA BASES 


LOGICAL VOLUME TABLE (LVT) 


® THE LOGICAL VOLUME TABLE (LVT) IS A. HARDCORE, PAGED DATA BASE 
MAINTAINED BY VOLUME CONTROL 


| ONE LVT PER SYSTEM 


® THE LVT CONTAINS AN ARRAY OF LOGICAL VOLUME TABLE ENTRIES (LVTE'S) 


| ONE LVTE FOR EACH MOUNTED LOGICAL VOLUME | ane 


® EACH LVTE DESCRIBES THE LOGICAL VOLUME TO INCLUDE: 


J LVID AND AIM CLASSIFICATION 


J RELATIVE POINTER TO THE THREAD OF PVTE'S OF ACCEPTED PHYSICAL 
VOLUMES THAT ARE MEMBERS OF THE LOGICAL VOLUME 
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VOLUME MANAGEMENT DATA BASES 


LOGICAL VOLUME TABLE (LVT) 


= THE LVT IS REQUIRED AT THE FOLLOWING TIMES: 
| SEGMENT CREATION 
| SEGMENT MOVING TIME 
L VoLUMe MOUNTING AND DEMOUNTING 


J INITIATION AND SEGMENT FAULT TIME (FOR PUBLIC/PRIVATE CHECK) 
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VOLUME MANAGEMENT DATA BASES 


PHYSICAL VOLUME HOLD TABLE 


Bae ee 1 1 
o 123 4 5 6 7 8 §$ O 2 3 5 6 


PYT R_PTR (1) APTE R_PTR (1) 
PYT R_PTR (2) APTE R_PTR (2) 


PVT R_PTR (64) APTE R_PTR (64) 


(WORD) (pv_holdt.inei.pit) 


PHYSICAL VOLUME HOLD TABLE 


AN INTERNAL STATIC ARRAY IN get —Pv = — ONE PER SYSTEM 


THE PHYSICAL VOLUME HOLD TABLE (PVHT) IS A HARDCORE DATA BASE 
MAINTAINED BY VOLUME MANAGEMENT 


J ONE PVHT PER SYSTEM 


THE PVHT IDENTIFIES THE PHYSICAL VOLUME AND THE PROCESS ID OF 
PROCESS THAT HAS STARTED (AND HAS NOT YET COMPLETED) COMPOUND 
OPERATIONS UPON THE PHYSICAL VOLUME 


THIS INFORMATION PREVENTS A LUME FROM BEING DEMOUNTED WHILE SUCH 
AN OPERATION IS IN PROGRESS 
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VOLUME MANAGEMENT DATA BASES 


PHYSICAL VOLUME HOLD TABLE 
- @ INTERRUPTION OF A COMPOUND OPERATION CAUSES THE VOLUME TO RE MARKED 


AS CONTAINING AN INCONSISTENCY 


@ FOR CRASH ANALYSIS, sst.pvthp CONTAINS A POINTER TO THIS TABLE 
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VOLUME MANAGEMENT OPERATIONS 


ACCEPTANCE OF PHYSICAL VOLUMES 


® THE ACCEPTANCE OF PHYSICAL VOLUMES IS THE MOST IMPORTANT AND 
FUNDAMENTAL OPERATION OF VOLUME MANAGEMENT ~ 


® PHYSICAL VOLUME ACCEPTANCE IS ACCOMPLISHED BY CALLING 
initializer_gate_Saccept_fs_disk 


8. THE ROOT PHYSICAL VOLUME - (RPV): ‘IS ACCEPTED IN A SPECIAL FASHION 
’ DURING COLLECTION 2 OF BOOTLOAD 


| THE RPV IS THE ONLY PV REQUIRED TO BOOTLOAD THE SYSTEM (MORE OF 
THE RLV WILL BE ACCEPTED BY RING ZERO DURING BOOTLOAD IF POINTED 
TO BY THE "ROOT" CONFIGURATION CARD) 


= ACCEPTANCE INCLUDES : 


J VALIDATE THAT THE DISK PACK MOUNTED IS THE PACK REQUESTED BY THE 
OPERATOR OR REQUESTING PROCESS VIA label. pvid 


] DETERMINE THAT THE DISK PACK MOUNTED IS IN FACT A. MEMBER OF THIS 
HIERARCHY VIA label.root_pvid 


] INITIALIZING THE APPROPRIATE PVTE WITH DATA FROM THE LABEL, 
VOLUME MAP, AND VTOC MAP 
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VOLUME MANAGEMENT OPERATIONS 


ACCEPTANCE OF PHYSICAL VOLUMES 


1 INITIALIZING THE INITIAL CONTENTS OF THE RECORD STOCK AND VTOCE 
STOCKS » 


| DETERMINING IF ANY VOLUME INCONSISTENCIES ARE PRESENT, AND 
LOGGING THIS INFORMATION | 


] VOLUME INCONSISTENCIES ARE CAUSED BY EVENTS WHICH MAY MEAN 
THAT THE DISK RESIDENT COPY OF THE VOLUME MAP OR VTOC MAP IS 
‘ENCONSISTENT: : 


LL: K ‘CRASH | ‘WITHOUT ESD <- INDICATED ‘BY lJabel.time_map_ updated 
and label. time: -_ unmounted | -BEING UNEQUAL, DETECTED AT 
ACCEPTANCE TIME 


f AN INCONSISTENCY DETECTED ONLINE, SUCH AS AN INVALID VTOC 
BIT MAP OR A REUSED ADDRESS 


f AN 1/0 ERROR WHEN WRITING THE VOLUME MAP OR VTOC MAP 
DURING NORMAL OPERATION 
{ A COUNT IS KEPT IN THE LABEL, AND UPDATED AS NECESSARY 
] NORMALLY, INCONSISTENCIES ARE: MERELY LOGGED, AND LEFT FOR THE 
- SITE TO TAKE CARE OF AT SOME CONVENIENT TIME 
J j$<IF AN RLV VOLUME CLAIMS ONLY A VERY SMALL NUMBER OF FREE ~ 
PAGES, A VOLUME SALVAGE IS DONE AUTOMATICALLY TO TRY TO 


RECOVER ANY LOST DUE TO. THE INCONSISTENCY, SINCE A FULL 
RLV WILL CAUSE SYSTEM CRASHES 
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VOLUME MANAGEMENT OPERATIONS 


ACCEPTANCE OF PHYSICAL VOLUMES 


| . WRITING OUT THE LABEL TO UPDATE label.time_map updated... 


J NOTE: label.time_map_updated AND label.time_unmounted ARE 
NOW UNEQUAL — 


. THIS INEQUALITY IMPLIES THAT THE VOLUME HAS NOT BEEN PROPERLY 


SHUT DOWN, AND WILL BE MARKED INCONSISTENT IF ACCEPTED AGAIN 
IN THIS STATE . 


| MARKING THE PVTE AS "IN- USE" (LAST STEP) 
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VOLUME MANAGEMENT OPERATIONS 


DEMOUNTING OF PHYSICAL VOLUMES 


@ THE DEMOUNTING OF PHYSICAL VOLUMES INVOLVES REVERSING ALL OF THE 
. STEPS TAKEN AT ACCEPTANCE TIME | 


® DEMOUNTING IS COMPLICATED BY THE FACT THAT THE PV MAY BE IN USE AT . 
THE TIME . 


@ “DEMOUNTING IS ACCOMPLISHED BY CALLING demount_pv ("THE DEMOUNTER")- 
® ALL VOLUMES ARE DEMOUNTED AT SHUTDOWN TIME 


@ DEMOUNTING INCLUDES: 


] TURNING ON pvte.being.demounted AND WAITING FOR ALL COMPOUND 
OPERATIONS TO TERMINATE 


J DEACTIVATING ALL SEGMENTS FROM THE PV WHICH ARE ACTIVE... THIS 
INCLUDES: 


{ FLUSHING MAIN MEMORY AND PAGING DEVICE (IF Rome erro OF ALL 
RELEVANT PAGES 
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VOLUME MANAGEMENT OPERATIONS 


DEMOUNTING OF PHYSICAL VOLUMES 


J UPDATING THE VTOCE'S FROM THE ASTE'S AND PAGE TABLES 


{ FLUSHING THE VTOC MANAGER'S BUFFER SEGMENT OF ALL RELEVANT 
VTOCE-PARTS . 


J EMPTYING THE RECORD AND. VTOCE STOCKS BACK INTO THE VOLUME MAP 
AND VTOC MAP 


..]| UPDATING THE. VOLUME LABEL FROM THE PVTE, PARTICULARLY 
J label.time_unmounted, label.time_map_ updated, AND 


label.inconsistency_count 


f PHYSICALLY CYCLING DOWN THE DISK DRIVE 


{ NOT DONE AT SYSTEM SHUTDOWN, HOWEVER 


® ONLY ONE PV MAY BE DEMOUNTED AT A TIME 
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VOLUME MANAGEMENT OPERATIONS 


LOGICAL VOLUME MANAGEMENT 


g LOGICAL VOLUME MANAGEMENT INCLUDES: 


f{ MAINTAINING THE LOGICAL VOLUME TABLE (LVT) TO REFLECT THE STATE © 
OF THE LOGICAL VOLUMES 


] MAINTAINING, IN THE KNOWN SEGMENT TABLE (KST) OF EACH PROCESS, A 
_ . TABLE OF PRIVATE LOGICAL VOLUMES MOUNTED TO THE PROCESS 


{| ANSWERING THE QUESTION OF WHETHER OR NOT A GIVEN LOGICAL VOLUME 
IS MOUNTED TO THE CALLING PROCESS 


f OR, IF A PUBLIC LV, MOUNTED AT ALL (TO THE SYSTEM) 


J PROVIDING THE HEAD OF THE PVT CHAIN FOR A GIVEN LV, FOR THE 
SEGMENT CREATION FUNCTION 
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VOLUME MANAGEMENT COMMANDS 


print configuration deck 


DISPLAYS >sli>config_ deck, WHICH 


CONTAINS INFORMATION ABOUT DISK LOCATIONS, THE RLV, AND PARTITIONS 


[ ONLY THE PART OF THE CONFIG DECK RELEVANT TO VOLUME MANAGEMENT 
AND DISK CONFIGURATION IS SHOWN HERE 


root 


part 


part 


“part: 


prph 
chnl 


prph 
ehni 


prph 
chnl 


prph 
cnhni 


prph 
chnl 


mpc 
mpc 
mpc 
mpc 
mpc 
mpc 


dska 


“bos 
dump 
log. 


dska 
dska 


dskb 
dskb 


dske 
daske 


dske 
dske 


dskf 
dskf 


mspa 
mspb > 
mspc 
mspd 
mspe 
mspf 


16. dskb 25. 
dska “16. 

dska i16.. 
‘Aska 16. 

a 20. 2 

a 26% 2 

Bb 20; 2 

b 26. 2 

a 28. 2 

a 30. 2 

BD 32, 2 

Db 34. 2 

a’ 32. 2 

a 34. 2 
451i. a 20. 
451. b 20. 
607. a 28. 
607. b 28. 
451. b 32. 
607. a 32. 
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VOLUME MANAGEMENT COMMANDS 


print configuration deck 


@® DISK CONFIGURATION CONFIG CARDS 


1 ROOT 


] IDENTIFIES THOSE VOLUMES IN THE ROOT LOGICAL VOLUME WHICH 
HAVE H@ PARTITIONS, USED BY THE SUPERVISOR FOR PAGING OF 
SUPERVISOR SEGMETNS 


} PART 
| IDENTIFIES THE LOCATIONS OF CERTAIN IMPORTANT PARTITIONS 


f ONLY PARTITIONS NECESSARY FOR MULTICS OPERATIONS ARE 
IDENTIFIED, NOT ALT PARTITIONS 


f HC PARTITIONS ARE LOCATED BY THE ROOT CARD 


Le] 


’ PREAH DSKn, CHNL 


[ IDENTIFY PHYSICAL I/O CHANNEL ‘PATHS FOR ACCESSING DISK DRIVES 
1 MPC 


J IDENTIFY PHYSICAL CONNECTIONS TO MICROPROGRAMMED DISK 
CONTROLLERS 
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VOLUME MANAGEMENT COMMANDS 


list volts 


VOLS - DISPLAYS A TABLE OF 
UTILIZATION 


@ List_ 
SPACE 

Drive Records 
cske_17 64504 
adske_18 64504 
dska_05 36426 
dska_0¢ 36428 
dskb_19 36428 
dskp_26 56429 
dskb_ 27 36429 
dské 01 26308 
dske_03 36268 
dska_ OL 30268 
dske_ oc 36268 
dskbd_17 36269 
eskb_ 16 36268 
aske_13 450k 
dske_14 64504 
dske_C} 64503 
eske_o2 54503 
adske_ O03 64592 
adsxe_Ci 64593 
dske_O0&S 64504 
aske_10 6450% 
SSKC. 21 64503 
aske 22 64503 
dske_25 04503 
dske_3¢ 54503 
askc_07 64503 
aske_08 455 
dske_23 64504 
dske_24 64504 
eske_ 25 64504 
dske_26 64504 
dske_06 37089 
dska_12 37562 
dska_07 37309 
dska_6§ 36205 
dska_11 36205 
dska_16 31283 
dskb_ 23 36258 
Gskb_ 24 36209 
dskb_ 25 36350 
Not To Be 
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ONLINE VOLUMES, THEIR LOCATION, 


% 


Avg 


PY 


Size Name 


00 00 Pb 0 UT SE OUT OD I OOO OW ds a to 


nN 
N 


— 
ee eno FF a~ 


alpha} 
alphad2 
mul03 
mulOi 
mulS2 
muldO5 
mulOu 
pud0d i 
pup07 
pubOdLl 
pubo2 
pub0s | 
pubds 
rel0l 
reld2 
xpupn0 1 
xpup02 
xpub03 
xpubds% 
xpub05 
xpubd0s 
ypub0} 
ypub02 
ypub05 
ypusdg 
zpub0i 
zpub02 
zpub03 
zpubO04L 
zpub05 
Zpubd6 
}istOl 
list02 
Tist05 
roots 
root6é 
rpv 
root3 
rooth 
reot2 


AND 


LV Name 


hipha 
Alpha 


Multics Pubs 
Multics_ Pubs 
Multics Pubs 
Multics Pubs 
Multics Pubs 


Pus | ts 
Public 
Public 
Public 
Public 
Pub LTS 
Release 
Reiease 
Xouslic 
Xpublic 
Apublic 
Xpuclic 
Xpublic 
Xpublic 
Ypub!lic 
Ypubire 
Ypublic 
Youbli<¢ 
Zoublic 
Zpubliic 
Zpublic 
Zpudlic 
Zpublic 
Zpublic 
list_l 
list_2 
list_3 
root 
root 
root 
root 
roct 
root 


VOLUME MANAGEMENT COMMANDS 


display label 


® DISPLAY LABEL - DISPLAYS THE LABEL OF A STORAGE SYSTEM VOLUME BY 


READING IT FROM DISK 


J USED / FREE INFORMATION IS COPY ON DISK, AND THEREFORE OUT OF 


DATE WITH RESPECT TO THE PVTE 


Label for Multics Storage System Volume rpv on dska_01 d451 


PVID 220531524345 
Serial rpv 
Logical oltime root 
LVID 220531524466 
Registered 01/28/81 1249.5 
Dismounted 03/15/83 0741.9 
Map Updated 03/15/83 0744.6 
Salvaged 10/01/82 0300.3 
Bootload 03/15/83 0743.5 
Reloaded 01/28/81 1510.1 
Dumped 
Incremental 03/17/83. 2153.0 
Consolidated 03/16/83 2359.3 
Complete 03725/83. 2353.0 
Inconsistencies 0 
Minimum AIM 0:000000 
TETITLT? 


Maximum AIM 


Volume contains Root (>) at vtocx 0 
disk_table_ at vtocx 100 (uid 033022210261) 


Volume Map from Label 


First Rec (Octal) Size 

0 0 8 Label Region: 

8 10 2000 VTOC Region 
2008 3.730 2008 he Partition 

_ 4016 7660 33901 Paging Region 
37347 112035 200 bos Partition 
38117 112345 1414 alt Partition 

38258 Total Size 
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VOLUME MANAGEMENT COMMANDS 


display pvte 


@ DISPLAY _PVTE ~ DISPLAYS THE PVT ENTRY OF A STORAGE SYSTEM VOLUME 


] PARTITION INFORMATION IS NOT DETAILED IN THE PVTE, BUT USED/FREE 
INFORMATION IS COMPLETELY UP TO DATE 


PVTE for Multics Storage System Volume rpv on dska_01 d451 at pvt|50 


PVID 220531524345 
LVID 220531524466 
VTOCES 
Number 10000 
Left S323 
Records 
Number 33907 
Left 3796 
Inconsistencies 0 
Volume Map 
volmap_seg ASTE 15| 4420 
record stock 761100 
Page 0 - Base 7660 
Free 3354 
Page i - Base 103660 
. Free 3740 
Page 2 - Base 203660 
Free 0 
vtoce stock 76|2400 
ON: storage system permanent hc_part_used 


OFF’ 


being -mounted being demounted being demounted2 


scav_check_ address device_inoperative vacating 
dmpr_in_use(incr) dmpr_in_use(cons) dmpr_in_use(comp) 


Volume Map from PVTE 


First Rec (Octal) 
0 0 

8 10 

2008 3740 
4016 7660 
37917 Le2Oso 
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VOLUME MANAGEMENT METERS 


disk meters 


& DISK_METERS - DISPLAYS I/O ACTIVITY TO DISK DRIVES 


J ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 


Total metering time 
Subsystem dska 


call locks 
run locks 


interrupt locks 
allocations 
Drive Reads 
al 269 
3 362 
4 309 
5 547 
6 631 
7 0 
8 5843 
9 366 
a hes i 3501 
LZ 0 
16 7158 
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0:20:12 


Count 


26005 

112 
25998 
26001 


Writes 


67 
243 


Waits 


217 
0 
239 
0 


Seek 


Distance 


214 
109 
184 
180 
161 
) 
12 
£53 
200 
0 
135 


%Waits 


0.83 
0.00 
0.92 
0.00 


ATB 
Reads 


4508 . 


3350 
3925 
22i7 
1922 
0 
207 
ee 
346 


0 
169 


] 


Avg. Wait(ms.) | 


0.259 
0.000 
0.208 
0.000 


ATB 
Writes 


18102 
4991 
9258 
7350 
7330 

0 

554 
10455 
847 

0 

483 
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VOLUME MANAGEMENT METERS 


device meters 


® DEVICE METERS - DISPLAYS SUMMARY OF I1/0 ACTIVITY FOR ALL DISK 


SUBSYSTEMS 
Total metering time O:20s13 

dska dskb dskc dskd 
Prior Page 1/0 18571 17743 462 L273 
ATB 65.334 68.383 2626.240 953,124 
Other Page 1/0 6525 5135 16 696 
ATB 185.949 236.284 106324692 1743.280 
ATB Page 1/0 48.347 53.034 2538.332 616.212 
Prior VTOCE I/0 934 895 38 304 
ATB 1299 .062 1.355.666 31929.554 3991.194 
ATB 1/0 46.612 91.037 2351.401 5334798 
% Busy 76 74 0 4 
Avg. Page Wait 47.285 46.197 20342 24.666 
Avg. Page “Wait 1765082 101.023: * 36.996 61.704 
Avg VTOCE Wait 41.138 37<610 36.2595 29.030 
Avg. Page 1/0 T 35619 38.314 20.050 22.482 
Avg. VTOCE 1/0 T S139 32.277 37.060 26.606 
EDAC Corr. Errs - 0 0 0: O.. 
Errors 0 0 0 a 


Fatal Errors 0 0 0 0 
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VOLUME MANAGEMENT METERS 


disk queue 


® DISK_QUEUE - DISPLAYS I/O QUEUE FOR A DISK SUBSYSTEM 


J ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 


° 


Connects = 2604781, 1359725, 677321, 309367, 
123430, 40159, 10227, 1969. 


P RW VP DV SECTOR 
0 W P 24 1350330 
0 W P 9 1020150 
0 W P 16 1204130 
Oo W P 16 314370 
O W P 16 314430 
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TOPIC VII 


Segment Control 


Segment Control Overview... 
Segment Control Terminology. . 
Segment Control Data Bases .. 


Volume Table of Contents (VTOC) 


Active Segment Table (AST) 
Services of Segment Control. . 
Creating Segments. .. 
Segment Fault. .... 
Segment Activation... 
Segment Trailers ... 
Boundsfault Handling . 
Segment Deactivation. . 
Summary of Major Services 
EBncacheability 4 é.-% <. 
Truncating Segments. 
Deleting Segments. . 
Other Services... 
Segment Control Meters . 
file _system_ meters . 
vtoc_ buffer meters . 
Segment Control Commands 
print_aste_ptp... 
dump_vtoce . . oe 
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SEGMENT CONTROL OVERVIEW 


® FUNCTION 


f SEGMENT CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF LOGICAL 
_ MEMORY 


| ITS TASKS INCLUDE: 


| MAINTAINING THE DISK RESIDENT MAPS OF SEGMENTS (IE: THEIR 
VTOCE'S) 


] SEGMENT CREATION, TRUNCATION AND DELETION 


] SEGMENT ACTIVATION AND DEACTIVATION (ASTE MULTI PLEXING) 


] SEGMENT CONTROL CAN BE INVOKED EITHER BY SUBROUTINE CALLS OR BY 
SEGMENT FAULTS 


® BASIC PHILOSOPHY OF ACTIVATION/DEACTIVATION 


) OF ALL SEGMENTS RESIDENT WITHIN THE SYSTEM'S MOUNTED PHYSICAL 
VOLUMES, ONLY A SMALL SUBSET WILL REQUIRE ACCESSING AT ANY ONE 
TIME. SUCH SEGMENTS WILL BE CALLED "ACTIVE SEGMENTS" 


1 A PART OF MAIN MEMORY, CALLED THE "ACTIVE SEGMENT TABLE" (AST), 
WILL BE RESERVED TO HOLD MANAGEMENT INFORMATION FOR THESE ACTIVE 
SEGMENTS (IDENTITY, PVT INDEX, LOCATION OF PAGES, ETC.) 
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SEGMENT CONTROL OVERVIEW 


| AS SEGMENTS FALL INTO DISUSE, THEIR "MANAGEMENT INFORMATION" IN 
THE AST WILL BE REPLACED WITH INFORMATION OF OTHER SEGMENTS 
REQUIRING ACTIVATION 


@® USER INTERFACE 


| COMMAND LEVEL 


J create, delete, truncate, etc. 


f SUBROUTINE LEVEL 


J hes _Sappend_branch, hes_Sappend_branchx, hes _Sdelentry seg, 
hes Sdelentry_file, hes_Struncate_seg, hcs_Struncate file, 
hes_S$force_write, etc 


® MAJOR DATA BASES 


1 SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM, SHARED WITH PAGE 
CONTROL. ONE MAJOR COMPONENT 1S "OWNED" BY SEGMENT CONTROL: 


f ACTIVE SEGMENT TABLE (AST) - ONE PER SYSTEM 
] THE AST IS A LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 
] ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER ACTIVE SEGMENT 
J ASTES CONTAIN PHYSICAL VOLUME ID'S (PVID'S) AND VTOC 


INDEX'S (VTOCX'S) OF SEGMENTS. NEEDED BY SEGMENT CONTROL 
TO FIND THE SEGMENT ON DISK (HARDWARE) 
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SEGMENT CONTROL OVERVIEW 


| AST HASH TABLE 
| ALLOWS EFFICIENT SEARCHING OF ASTE'S 


J LOGICALLY enn? OF THE AST, BUT ELSEWHERE FOR HISTORICAL 
REASONS 


| DIRECTORY SEGMENTS 


] CONTAIN LOCATIONS AND ATTRIBUTES OF SEGMENTS. LOCATION 
INFORMATION FROM DIRECTORY SEGMENTS IS PROVIDED TO SEGMENT 
CONTROL BY DIRECTORY CONTROL 


J VOLUME TABLE OF CONTENTS (VTOC) - ONE PER PHYSICAL VOLUME 


J VOLUME TABLE OF CONTENTS ENTRY (VTOCE)> += ONE PER 
DISK-RESIDENT SEGMENT | 


f EACH VTOCE CONTAINS THE SEGMENT'S UNIQUE ID, CURRENT LENGTH, 
FILE MAP, ETC (NEED TO BUILD ASTE'S AND PT'S) 


) VTOCES ARE READ AND WRITTEN ONLY BY SEGMENT CONTROL 


J VTOCE STOCKS - FROM VOLUME MANAGEMENT 


) USED WHEN CREATING AND DELETING VTOCES FOR SEGMENTS 
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MULTIPLEXING: 


VTOC: 


VTOCEs 


SEGMENT: 


SEMI - PERMANENT 


SEGMENT CONTROL TERMINOLOGY 


CONTROLLED SHARING OF A REUSABLE RESOURCE 


VOLUME TABLE OF CONTENTS (ONE PER PV). AN ARRAY OF 
VTOCE'S IDENTIFYING ALL SEGMENTS RESIDENT ON THE 
PHYSICAL VOLUME 


VOLUME TABLE OF CONTENTS ENTRY (ONE PER RESIDENT 
SEGMENT). CONTAINS IDENTIFICATION AND LOCATOR 
INFORMATION ABOUT A SEGMENT RESIDENT WITHIN THE 
PHYSICAL VOLUME 


A COLLECTION OF INFORMATION (PROCEDURE OR DATA) GROUPED 
TOGETHER UNDER THE SAME ACCESS CONTROL CONSTRAINTS. 
EACH SEGMENT IS GIVEN ONE OR MORE NAMES AND A- 
COLLECTION OF ATTRIBUTES INCLUDING LENGTH, ACCESS 
PERMISSIONS, ETC 


ACTIVATISS: A SEGMENT AND TURNING ON ITS ENTRY HOLD 
SWITCH (aste.ehs) PREVENTING NORMAL (ASTE CONTENTION) 
DEACTIVATION 
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SEGMENT CONTROL DATA 


VOLUME TABLE OF CONTENTS (VTOC) 


| nussaenaien Ge 8 


2 <——_E er 


3 DATE TIME USED (DTU) 
4 OATE TIME MODIFIED (OTM) 


BASES 


10 WORDS OF QUOTA RELEVANT INFORMATION TO INCLUDE 
THE TIME-RECORD PRODUCT AND USAGE COUNT 


16 FILE MAP (0) FILE MAP (1) 


e 
° 


i 
63 FILE MAP (94) : 


64 _ FILE MAP (S6) 


WF ’ FILE MAP (222) 


328 FILE MAP (224) 


143 FILE MAP (254) 


10 WORDS NOT USED 


Co tere Hse pct oe y Paley t vloce Shoke 
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FILE MAP (95) 


FILE MAP ($7) 


FILE MAP (223) 


FILE MAP (225) 


FILE MAP (255) 


wun Ber oF 


fore ee oe 


SUALLY SUFFICIENT) ~~ 


(64 WORDS 


pon COO cecorkt 


ACTIVATION INFO | -- ~~~ 


A\iorS 


“fo Use a 


rn 


|. 


PART 
© (64 WORDS) © 


fib e MAP 


-+- 


PART HI 


(64 WORDS) 


Ayer @ 
CASK, 


yy 


Arsh 


Ad des 


SEGMENT CONTROL DATA BASES 


VOLUME TABLE OF CONTENTS (VTOC) 


SEGMENT CONTROL DATA BASES 


VOLUME TABLE OF CONTENTS VTOCE 


156 

155 DATE TIME DUMPED (DTD) 

156 VOLUME ID (1) (INCREMENTAL DUMP TAPE 1D) 

157 VOLUME ID (2) (CONSOLIDATED DUMP TAPE ID) 

158 VOLUME ID (3) (COMPLETE DUMP TAPE 10) 

159 UID OF MASTER DIRECTORY 

160 UID OF SUPERIOR DIRECTORY (0) 

175 UID OF SUPERIOR DIRECTORY (15) 

, 2 WORDS CONTAINING THE SEGMENT’S 

ORIGINAL PRIMARY NAME 

184 DATE_TIME VTOCE CREATED 

185. , PVID OF VOLUME OF PARENT DIRECTORY 


186 PARENT VTOC INDEX SEGMENT BRANCH OFFSET IN PARENT 
187 TIME THIS VTOCE CHECKED FOR CONNECTION FAILURE 


ACCESS ISOLATION MECHANISM (AIM) CLASS 


PVIO OF VOLUME FOR THIS VTOCE , 


(WORDS) ivtoce.inci.pi1) 


VOLUME TABLE OF CONTENTS ENTRY (VTOCE} 


& DISK RESIDENT DATA BASE — ONE PER SEGMENT 
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SEGMENT CONTROL DATA BASES 


VOLUME TABLE OF CONTENTS (VTOC) 


® THE "VOLUME TABLE OF CONTENTS” (VTOC) IS A DISK RESIDENT DATA BASE 
CONTAINING (OF INTEREST HERE) AN, ARRAY OF ENTRIES KNOWN AS "VOLUME 
TABLE OF CONTENTS ENTRIES" (VTOCE'S) 


f ONE VTOC PER PHYSICAL VOLUME 


f ONE VTOCE PER SEGMENT 


® EACH VTOCE CONTAINS RESIDENCY INFORMATION (AND SOME ATTRIBUTE 
INFORMATION) OF A PARTICULAR SEGMENT 


{ CONSEQUENTLY, THE PAIR OF PVID AND VTOC INDEX UNIQUELY 
IDENTIFIES ANY SEGMENT IN THE STORAGE SYSTEM HIERARCHY 


® EACH VTOCE IS 192 WORDS LONG AND IS DIVIDED INTO THREE LOGICAL 
PARTS: 


) ACTIVATION INFORMATION (16 WORDS) 


J CONTAINS ALL INFORMATION (EXCLUDING THE FILE MAP) NEEDED TO 
USE THE SEGMENT, OR MORE TECHNICALLY, TO ACTIVATE THE SEGMENT 
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SEGMENT CONTROL DATA BASES 


VOLUME TABLE OF CONTENTS (VTOC) 


] INCLUDES: UID, CURRENT LENGTH, RECORDS USED, MAXIMUM 
LENGTH, RECORDS USED, ETC 
) ALL INFORMATION LIKELY TO CHANGE BECAUSE OF THE ACTIVATION 


J INCLUDES: DATE TIME MODIFIED AND USED, QUOTA CELLS (IF A 
DIRECTORY).5. BTC 


| FILE MAP (128 WORDS) 


) AN ARRAY OF 256 RECORD ADDRESS OR NULL ADDRESS DETAILING 
WHERE EACH PAGE OF THE SEGMENT RESIDES 


! A NULL ADDRESS (NOT TO BE CONFUSED WITH A NULLED ADDRESS -- 
DISCUSSED LATER) INDICATES THAT NO RECORD OF THE VOLUME IS 
ASSIGNED TO. THAT PAGE OF THE SEGMENT 


J A RECORD ADDRESS IS THE ADDRESS OF THE RECORD ASSIGNED TO 
THAT PAGE OF THE SEGMENT (I.E., THE DISK RESIDENT HOME OF THE 
PAGE) 


J NOTE: PAGE CONTROL ENSURES THAT NO RECORD ADDRESS EVER. 
APPEARS (OR REMAINS) IN THE FILE MAP UNLESS THE PAGE ACTUALLY 
APPEARS ON THE VOLUME 


] PERMANENT INFORMATION (48 WORDS) 
) CONTAINS ATTRIBUTES WHICH RARELY (IF EVER) CHANGE SUCH AS: 


J UID'S OF SUPERIOR DIRECTORIES, AIM CLASSIFICATION, DATE 
TIME. DUMPED (BY PHYSICAL VOLUME DUMPER) 
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SEGMENT CONTROL DATA BASES 


VOLUME TABLE OF CONTENTS (VTOC) 


@ EACH VTOCE IS ALSO DIVIDED INTO THREE PHYSICAL PARTS: 


] FIRST SECTOR (WORDS 0-63): 


f CONTAINS ALL “ACTIVATION INFORMATION" AND THE FIRST PORTION 
° OF THE FILE MAP 


J SECOND SECTOR (WORDS 64-127): 


f CONTAINS THE BULK OF THE FILE MAP 
) THIRD SECTOR (WORDS 128-191): 


1 CONTAINS THE END OF THE FILE MAP AND ALL “PERMANENT 
INFORMATION" ; 
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SEGMENT CONTROL DATA BASES 


VOLUME TABLE OF CONTENTS (VTOC) 


® VTOCE 1/0 


[ USING RECORD 1/0 (IN UNITS OF 1024 WORDS) TO ACCESS A VTOCE (192 
WORDS) WOULD HAVE EXCESSIVE OVERHEAD FOR BUFFERS 


) FURTHERMORE, BECAUSE MOST SEGMENTS ARE SMALL, MOST VTOCE 
ACCESSING IS ONLY. CONCERNED WITH ACTIVATION INFORMATION AND THE 
FIRST PORTION OF THE FILE MAP, I.E., THE FIRST SECTOR (64 WORDS) 


[ TO TAKE ADVANTAGE OF THESE FACTS, VTOCE'S ARE ACCESSED VIA 
- SECTOR 1/0, NOT RECORD 1/0 


) A LARGE MECHANISM KNOWN AS THE VTOC MANAGER (vtoc_man) EXIST TO 
EFFICIENTLY MANAGE THIS SECTOR 1/0 AND ITS BUFFERING 


J VTOCE 1/0 IS THE ONLY NON-PAGE 1/0 DONE TO DISK 


} VTOCE 1/0 IS DONE IN PARTS (SECTORS) 


f FOR A SEGMENT, OR A DIRECTORY WITHOUT TERMINAL QUOTA, PARTS 
ONE AND TWO CAN BE WRITTEN ENTIRELY FROM INFORMATION DERIVED 
FROM THE ASTE, AND NEED NOT BE READ IN FIRST 


] PART THREE MUST ALWAYS BE READ BEFORE BEING WRITTEN, AS MUST 
PART ONE FOR A DIRECTORY WITH QUOTA 


) ALL THREE PARTS OF A VTOCE ARE ALWAYS READ WHENEVER ANY PART 
IS REQUESTED, IN CASE THE OTHERS ARE NEEDED SOON AFTERWARDS 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


1 FY 4 Ft © FY T 7 GF FT 2 2 
9123 45 6 7 8 YY @ t+ 23 € § 6 7 8B FS O 1 


6 FORWAAD R_ PTR BACKWARD R_PTR 


NEXT BROTHER R_PTR | FIRST SON R_PTR 


SYSTEM TRAILER R_PTR PARENT R_PTR 
SEGMENT'S UNIQUE IDENTIFIER (UID) 


oim 

16 
t 
R 


222 2 2 2 2 2 3 3 3:3 3 ~*3 
23 4645 6 7 8 $$ 6 1 2 3 4 § 


Ole 
Q 


8 
. DATE TIME USED (DTU) 
DATE TIME MODIFIED (OTM) 
SEGMENT QUOTA USAGE | DIRECTORY QUOTA COUNT 
| 

SEGMENT QUOTA USED | DIRECTORY QUOTA USED 

CURRENT LENGTH | : RECORDS USED | NO. OF PAGES 
e |? : B 
HASH TABLE R_PTR aes s | MARKER 
7 = er het x a si es a) 1 L 


ve ACTIVE SEGMENT TABLE ENTRY (ASTE) sent?) 


A WIRED (SST) OATA BASE — ONE PER ACTIVE SEGMENT 


MAIN MEMORY AODORESS 


‘WORDSI iPTW.INCL.PL 1) pues R errors 
A 16K PAGE TABLE (PT) > 
= ( Vy grr Vio) 6 ( ¥Y 
S of | IMMEDIATELY FOLLOWS AN ASTE (ABOVE! ~ ONE PER ACTIVE SEGMENT ene see, 
Sic) ov | COMES IN 4, 16, 64 AND 256K FLAVORS OPT AIT *S olor 
Lo TR oa Secper 3 ‘ 


VToc by FF (wired) 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


® THE ACTIVE SEGMENT TABLE (AST) IS A HARDCORE, WIRED, UNPAGED, DATA 
BASE LOCATED WITHIN THE SYSTEM SEGMENT TABLE (SST), AND CONSISTS OF 
AN ARRAY OF PAIRED ENTRIES KNOWN AS ACTIVE SEGMENT TABLE ENTRIES 
(ASTE'S) AND PAGE TABLES (PT'S) 


f ONE AST PER SYSTEM 


| ONE ASTE/PT PAIR PER ACTIVE SEGMENT 


® IN ORDER FOR A SEGMENT TO BE ACCESSED VIA THE HARDWARE, VTOCE 
INFORMATION MUST BE BROUGHT INTO MAIN MEMORY 


& THE 12 WORD ASTE (AND ITS ASSOCIATED PAGE TABLE) CAN BE THOUGHT OF 
- AS THE MAIN MEMORY RESIDENT IMAGE OF THE VTOCE 


| SPECIFICALLY, THE ASTE CONTAINS: 


f THE VTOCE'S "ACTIVATION INFORMATION" SUCH AS THE SEGMENTS 
UID, CURRENT LENGTH, MAX LENGTH, DTU, DTM, QUOTA DATA 


J AND NON-VTOCE INFORMATION SUCH AS: PVT INDEX, VTOC INDEX, 
VARIOUS FLAGS AND POINTERS 


| THE PAGE TABLE CONTAINS THE RECORD ADDRESS (TAKEN FROM THE 
VTOCE'S "FILE MAP") OF EACH NONZERO PAGE OF THE SEGMENT 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


® A SEGMENT HAVING AN ASTE AND A PAGE TABLE IS SAID TO BE ACTIVE 


) "ACTIVATING" A SEGMENT IS THE PROCESS OF ALLOCATING (AND FILLING 
IN) AN ASTE AND A PAGE TABLE FOR THE SEGMENT 


> 


l CONVERSELY, "DEACTIVATING" A SEGMENT INVOLVES FREEING ITS ASTE 
AND PAGE TABLE FOR FURTHER USE 


{ BEING ACTIVE DOES NOT IMPLY THAT THE SEGMENT IS ACTUALLY IN USE 
BY ANY PROCESS 


® SINCE THE AST 


MII NITTIDED AT AES 
45200 WUIOEA Yo mw 


HAVING FINITE SIZE), 


J ONLY A FINITE NUMBER OF SEGMENTS MAY BE ACTIVE AT ONE TIME 


. WHEN A NON-ACTIVE SEGMENT IS REFERENCED, AND THERE ARE NO FREE 
ASTE'S AVAILABLE, SOME SEGMENT MUST BE DEACTIVATED 


) THIS ASTE/PT .MULTIPLEXING IS THE PRIME RESPONSIBILITY OF 
SEGMENT CONTROL 


] BEING A FINITE (AND A CRITICAL) SYSTEM RESOURCE, THE NUMBER OF 
ASTE/PT PAIRS CAN DRAMATICALLY AFFECT THE COMPETITION FOR 
ASTE'S, AND CONSEQUENTLY SYSTEM PERFORMANCE 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


| TOO FEW ASTE/PT PAIRS WILL CAUSE "SEGMENT THRASHING" 


f .TOO MANY ASTE/PT PAIRS WILL OCCUPY MAIN MEMORY FRAMES THAT 
MIGHT BETTER BE UTILIZED FOR NORMAL PAGING TRAFFIC, PERHAPS 
LEADING TO “PAGE THRASHING" 


J CONSEQUENTLY, THE NUMBER OF ASTE/PT PAIRS IS A CRITICAL 
SYSTEM PARAMETER (SET ON THE SST CONFIG CARD) 


f OF THE TWO POSSIBILITIES, TOO MANY OR TOO FEW, TOO FEW IS 
BY FAR THE WORSE 
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CONNECTING AND FAULTING SDW'S 


273 


(] 


dseg 


PROCESS 
Jones.ASP.m 


302 ACTIVE SEGMENT 


ry TABLE 


dseg 


PROCESS 
Smith.FED. a 


261 


dseg 


PROCESS 
May.MED.a 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


® IN ORDER TO MAXIMIZE THE NUMBER OF ASTE/PT PAIRS WITHIN AN AST OF A 
GIVEN SIZE, ASTE/PT PAIRS COME IN FOUR FIXED SIZES: 


f ASTE + A 4 WORD PAGE TABLE (16 WORDS TOTAL) 


f’ FOR 0-4K SEGMENTS 


| ASTE + A 16 WORD PAGE TABLE (28 WORDS TOTAL) 


| FOR 5-16K SEGMENTS 
[ ASTE + A 64 WORD PAGE TABLE (76 WORDS TOTAL) 


J) FOR 17-64K SEGMENTS 


| FOR 65-256K SEGMENTS 
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A HARDCORE (SST) UN-PAGED DATA BASE — ONE PER SYSTEM 
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SEGMENT CONTROL DATA BASES 


256 WD PT 


ACTIVE SEGMENT TABLE (AST) 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


@® THE SIZE OF EACH OF THE FOUR ASTE POOLS IS DETERMINED AT SYSTEM 
INITIALIZATION BY THE SST CONFIG CARD AND IS A CRITICAL SYSTEM 
TUNING PARAMETER 


® SINCE THE FREQUENCY OF SMALL SEGMENTS IS HIGHER THAN THE FREQUENCY 
OF LARGE SEGMENTS, THE DISTRIBUTION OF ASTE'S IS NORMALLY AS 
FOLLOWS : 


1 4K > 16K > 64K > 256K 


f ON SYSTEM-M, IN PHOENIX, A 6 CPU, 8MW MEMORY, 200 USER SYSTEM, 
THE ASTE DISTRIBUTION IS NORMALLY: 


3500 1500 750° 250 


ON MIT-MULTICS, A 3 CPU, 3.5MW MEMORY, 110 USER SYSTEM, THE ASTE 
DISTRIBUTION IS NORMALLY: 


® A SEGMENT NORMALLY REMAINS ACTIVE (FOR >200 SECONDS) UNTIL FORCED 
TO GIVE UP ITS ASTE/PT PAIR TO ANOTHER SEGMENT (DEACTIVATION) 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


THIS DEACTIVATION CONSISTS OF: 


MAKING THE SEGMENT INACCESSIBLE TO USER PROCESSES 
) DONE BY "CUTTING TRAILERS", IN THE PROGRAM setfaults.pli 


f A LIST OF ALL SEGMENTS CONNECTED TO (USING) THE SEGMENT IS 
KEPT FOR THIS PURPOSE 


EVICTING ALL PAGES OF THE SEGMENT FROM MAIN MEMORY 


f ONLY MODIFIED PAGES MUST BE WRITTEN BACK TO DISK. UNMODIFIED 
PAGES ARE SIMPLY OVERWRITTEN 


UPDATING THE VTOCE BY WRITING THE (POSSIBLY MODIFIED) ACTIVATION 
INFORMATION BACK TO THE VTOCE 


FREEING THE ASTE/PT PAIR 


SINCE ACTIVATING/DEACTIVATING SEGMENTS IS EXPENSIVE, THE CHOICE OF 
A SEGMENT FOR DEACTIVATION IS IMPORTANT, AND BELONGS TO THE SEGMENT 
REQUIRING ACTIVATION FURTHEST IN THE FUTURE 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


® THE ALGORITHM WHICH CHOOSES A "BEST" SEGMENT FOR DEACTIVATION IS 
IMPLEMENTED IN THE PROGRAM get_aste, AND CONSIDERS SUCH FACTORS AS: 


Not To 


THE PRESENCE OF ACTIVE INFERIORS (IF A DIRECTORY) 


THE NUMBER OF PAGES CURRENTLY IN MAIN MEMORY (SINCE WORK IS 
REQUIRED TO EVICT THE MODIFIED FRACTION OF SUCH PAGES AND 
BECAUSE THIS INDICATES "USED RECENTLY" IN SOME SENSE) 


IT LOOKS FIRST FOR A SEGMENT WITH NO INFERIORS, AND NO PAGES IN 
MEMORY, AND ALMOST ALWAYS SUCCEEDS - BUT IF IT FAILS, IT TRIES 
TO MAKE A "GOOD CHOICE", AND DEACTIVATES INFERIORS, AND/OR 
FLUSHES PAGES TO DISK IF NECESSARY 
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IMPLIED DIRECTION 
OF SEARCH 


TYPICAL “USED LIST” 


A DOUBLE THREADED LIST OF SIMILAR OBJECTS GENERALLY IMPLEMENTING 
REPLACEMENT ALGORITHMS. CONTAINS BOTH FREE AND IN—USE OBJECTS, WITH 
FREE OBJECTS MAINTAINED AT THE HEAD OF THE LIST. 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


NOTE: WHILE INSPECTING THE ASTE'S, OPPORTUNITY IS TAKEN TO NOTICE 
ASTE'S WHOSE FILE MAPS HAVE CHANGED AND.TO UPDATE THEIR VTOCE'S 


KNOWN AS "AST TRICKLE" 


THIS IS DONE TOTALLY AS A HEDGE AGAINST A FATAL CRASH, AS A 
SUCCESSFUL SHUTDOWN UPDATES ALL VTOCE'S OF ACTIVE SEGMENTS 


THIS IS NOT DONE FOR PROCESS DIRECTORY SEGMENTS, SINCE THEIR 
CONTENTS ARE OF LITTLE USE AFTER A CRASH 


THE “AST TRICKLE" IS ALSO FORCED TO OCCUR EVERY FIFTEEN MINOTES 
WHEN THE SYSTEM IS LIGHTLY LOADED, BECAUSE OTHERWISE VTOCES 
MIGHT REMAIN UNUPDATED FOR HOURS 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


s AST HIERARCHY 
) MIRRORS A SUBSET OF THE STORAGE SYSTEM HIERARCHY 
f THE ROOT DIRECTORY (>) CANNOT BE DEACTIVATED 


f NO SEGMENT (EXCEPT THE ROOT) MAY BE ACTIVE UNLESS ITS PARENT IS 
ACTIVE. THE REASONS FOR THIS ARE: 


1 PARENT MUST BE ACTIVATED IN ORDER TO FIND THE SON 


f ACTIVATION OF OTHER SONS IS EASIER IF THE PARENT REMAINS 
ACTIVE 


] THE QUOTA ACCOUNT AGAINST WHICH AN-ACTIVE SEGMENT'S "RECORDS 
USED" IS TALLIED SHOULD BE IMMEDIATELY AVAILABLE WHEN A 
SEGMENT CHANGES SIZE. THE QUOTA ACCOUNT IS FOUND IN ONE OF 
THE ANCESTORS' ASTES 


] DATE TIME MODIFIED (DTM) FOR A DIRECTORY IS THE DTM OF THE 
LAST MODIFIED SEGMENT IN THE SUBTREE. DTM OF ALL ANCESTOR'S 
SHOULD BE IMMEDIATELY AVAILABLE WHEN A SEGMENT IS MODIFIED. 
DTM IS FOUND IN THE ASTE OF THE ANCESTORS. (USED BY THE 


HIERARCHY DUMPER) 


1 SUCH UPDATES TO THE ASTE'S OF PARENTS . ARE PERFORMED BY PAGE 
CONTROL 


] EACH ASTE HAS A POINTER TO ITS PARENT'S ASTE FOR THE ABOVE 
REASONS. (THIS POINTER IMPLEMENTS THE AST HIERARCHY) 
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SEGMENT CONTROL DATA BASES 


ACTIVE SEGMENT TABLE (AST) 


ASTE'S MAY BE THREADED ONTO ONE OF SIX LISTS VIA THE RELATIVE 
POINTERS aste.fp and aste.bp 


[ FOUR USED LISTS: THREADS ALL FREE AND REPLACEABLE ASTE'S OF 
EACH POOL SIZE (sst.level.ausedp POINTS TO THE FIRST FREE ASTE 
IN “THE LIST) 


f INIT AND TEMP LISTS: USED AT SYSTEM INITIALIZATION TO RECEIVE 
(AND DELETE) INITIALIZATION AND TEMPORARY SEGMENTS 


THERE ALSO EXIST SEVERAL AUXILIARY LISTS SUCH AS THE HASH THREAD 
AND FATHER-SON, AND BROTHERS LISTS. 


ALL ACTIVE SEGMENTS IN THE HIERARCHY ARE IN THE FOUR USED LISTS - 
EACEPT FOR SEGMENTS IN THE HARDCORE PARTITION (THE PAGED 
SUPERVISOR), AND A SMALL CLASS OF SEGMENTS WHICH MAY NOT BE 
DEACTIVATED 


| SEGMENTS ARE SOMETIMES UNTHREADED FROM those USED. BISt 
TEMPORARILY IN ORDER TO KEEP THEM OUT OF REACH WHILE SOME 
COMPLEX OPERATION IS PERFORMED -— 
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SERVICES OF SEGMENT CONTROL 


CREATING SEGMENTS 


® SEGMENT CREATION IS PERFORMED BY THE PROCEDURE create_vtoce 
] <INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT 


f OUTPUT: PVID AND VTOC INDEX OF THE CREATED SEGMENT 


® create _vtoce MAY BE CALLED BY append (NORMAL SEGMENT CREATION) OR 
segment_mover (DUE TO PACK OVERFLOW) ~ 


® PRINCIPAL STEPS OF create _vtoce: 


1 CREATE A LOCAL IMAGE OF THE VTOCE TO BE CREATED 


J] FILL IN MOST ACTIVATION AND PERMANENT INFORMATION FROM THE 
BRANCH ENTRY “a 


J CREATE A NULL FILE MAP 


. DETERMINE THE UID PATH (UID'S OF SUPERIOR DIRECTORIES) 
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SERVICES OF SEGMENT CONTROL 


CREATING SEGMENTS 


f SELECT AN APPROPRIATE PV WITHIN THE LV SPECIFIED BY THE 
sons_lvid OF THE DIRECTORY IN WHICH THE BRANCH ENTRY APPEARS 


| SELECTION GOAL IS TO EVENLY DISTRIBUTE SEGMENTS OVER ALL PV'S 
OF THE LV, THEREBY REDUCING DISK CONTENTION 


. SELECTION ALGORITHM WALKS THE CHAIN ( THROUGH 
pyvte.brother_pvtx) OF PV'S IN THE LV AND SELECTS THE PV 
HAVING THE HIGHEST PERCENTAGE OF UNUSED RECORDS IN ITS PAGING 
REGION 


f NO PV IS ACCEPTED IF pvte.vacating IS ON, SIGNIFYING THAT 
sweep pv IS TRYING TO VACATE, OR INHIBIT CREATION UPON, THE 
PV 


f AN EXCEPTION Is MADE FOR PER PROCESS SEGMENTS 
(entry.per_process IS ON) 


J SINCE SUCH SEGMENTS ARE ALL HEAVILY USED, A ROUND ROBIN 


ALGORITHM EVENLY DISTRIBUTES THESE SEGMENTS ACROSS ALL 
Pv" S IN THE LV 


1 INVOKE THE VTOC MANAGER (vtoc_manSalloc_and_put_vtoce) TO 
ALLOCATE AND WRITE THE VTOCE IMAGE ON THE SELECTED PV 


) VTOC_MAN ATTEMPTS TO ALLOCATE A VTOCE FROM THE VTOCE STOCK 
FOR THE VOLUME 


J «IF THE STOCK IS EMPTY, IT REFILLS IT FROM THE VTOCE MAP ON 
DISK (SEE vtoce_stock_man.pli) 


f BECAUSE IT IS PERMISSIBLE TO TAKE PAGE FAULTS IN THE 
VTOC_MAN ENVIRONMENT, THE VTOCE STOCK 1S ACCESSED WITHOUT 
ANY SPECIAL PAGE CONTROL PROTOCOLS 


) RETURNS THE VTOC INDEX OF THE ALLOCATED VTOCE 
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SERVICES OF SEGMENT CONTROL 


CREATING SEGMENTS 


) RETURN THE PVID AND VTOC INDEX OF THE NEW SEGMENT TO THE CALLER 
(WHO RECORDS SAME IN entry.pvid AND entry.vtocx) 
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SERVICES OF SEGMENT CONTROL 


SEGMENT ACTIVATION 


® SEGMENT ACTIVATION IS PERFORMED BY THE PROCEDURE "activate" 
f INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT 


J OUTPUT: AN ASTE POINTER 


€ activate IS PRINCIPALLY CALLED BY seg fault (OF ADDRESS/NAME SPACE 
MANAGEMENT) WHO HAS LOCATED THE SEGMENT'S BRANCH ENTRY, VALIDATED 
THE USER'S ACCESS, AND CHECKED THE PRESENCE OF THE LV 


® PRINCIPAL STEPS OF activate: 


J LOCK THE AST LOCK AND CHECK IF THE SEGMENT 1S ALREADY ACTIVE. 
IF SO, UNLOCK THE AST AND RETURN ITS ASTE POINTER 


J j<IF THE SEGMENT IS NOT ACTIVE, UNLOCK THE AST AND READ IN ALL 
REQUIRED PARTS OF THE VTOCE AND COMPARE UID'S FOR CONNECTION 
FAILURE (IN WHICH CASE, DO NOT ACTIVATE AND RETURN AN ERROR) 


] ENSURE THAT THE SEGMENT'S PARENT IS ACTIVE 


) THIS IS DONE BY REFERENCING THE PARENT DIRECTORY (PERHAPS 
CAUSING A RECURSIVE SEGMENT FAULT AND ACTIVATION) AND SETTING 
THE aste.ehs BIT FOR IT TEMPORARILY WHILE ACTIVATION IS 
TAKING PLACE 
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SERVICES OF SEGMENT CONTROL 


SEGMENT ACTIVATION 


f NOTE THAT THE ONLY EXPLICIT ACTION TAKEN TO ACTIVATE THE 
PARENT IS TO REFERENCE IT; THE POSSIBLE RECURSIVE SEGMENT 
FAULT TAKES CARE OF EVERYTHING AND ALLOWS THAT REFERENCE T 
PROCEED 


J OBTAIN AN ASTE FOR THE SEGMENT BY CALLING get_aste. THIS MAY 
INVOLVE DEACTIVATING SOME OTHER SEGMENT - BUT HOPEFULLY NOT THE 
PARENT! (ENSURED BY THE aste.ehs BEING ON) 


] THREAD THE ASTE INTO THE INFERIOR LIST OF THE PARENT'S ASTE 
(THIS WILL KEEP HIM ACTIVE), AND RESET THE PARENT'S aste.ehs 


J FILL IN THE ASTE WITH THE VTOCE'S ACTIVATION INFORMATION AND 
INITIAL FLAG VALUES 


J CALL pesfill_page_ table (PASSING THE VTOCE'S FILE MAP) TO 
INITIALIZE THE PAGE TABLE AND OTHER PAGE CONTROL INFORMATION 


f PLACE THE UID IN THE ASTE AND HASH IT INTO THE AST HASH TABLE 


|. AFTER A SYSTEM FAILURE, ESD USES A ZERO UID AS A CUE THAT 
ASTE IS INVALID, AND DOES NOT INVOKE A VTOCE UPDATE FOR 
ASTE . 
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SERVICES OF SEGMENT CONTROL 


SEGMENT TRAILERS 


® WHEN A PROCESS IS USING A SEGMENT, AND IT HAS A VALID SDW FOR THAT 
SEGMENT, A RECORD MUST BE KEPT IN CASE IT IS NECESSARY TO REVOKE 
THAT SDW (WHEN THE SEGMENT IS DELETED, WHEN THE ASTE IS RE-USED, 
ETC) 


. THIS IS DONE BY THE SEGMENT TRAILER MECHANISM 


J EACH PROCESS WHICH HAS A VALID SDW FOR A SEGMENT HAS A 
"TRAILER ENTRY" WHICH RECORDS ITS PROCESS IDENTIFICATION AND 
THE SEGMENT NUMBER IT IS USING FOR THE SEEN aa \ Gases 

SS yR OM. RY BNE CaN 
contoe Poon STR SER 

J TRAILER ENTRIES ARE KEPT IN THE str_seg, A PAGED SUPERVISOR 
SEGMENT 


2 
AQrod xP 
ae 


f THERE IS A LINKED LIST OF TRAILER ENTRIES FOR EACH SEGMENT; 
THE HEAD IS POINTED TO BY aste.strp 


. TRAILERS ARE ONLY KEPT FOR SEGMENTS WHICH MAY BE DEACTIVATED: 
ORDINARY SEGMENTS AND DIRECTORIES, BUT NOT SUPERVISOR SEGMENTS 


) A TRAILER IS ATTACHED FOR A SEGMENT BY seq fault.pli BEFORE iT. 
PLACES THE SDW INTO THE DSEG FOR THE PROCESS 


1 TRAILERS ARE USED LATER BY setfaults.pli FOR: 
f DEACTIVATION - THE SDW IS ENTIRELY REVOKED (ZEROED) 


) ACCESS CHANGES, DELETION - THE SDW IS MADE INVALID, BUT ITS 
PAGE TABLE ADDRESS iS. LEFT UNCHANGED, INDICATING TO 
seg fault.pli THAT ALL IT MUST DO IS RECALCULATE THE ACCESS 
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SERVICES OF SEGMENT CONTROL 


SEGMENT TRAILERS 


) PROCESS TERMINATION - ALL SDWS A PROCESS HAD ARE REVOKED AT 
TERMINATION 


J CACHE CONTROL - WHEN THE ENCACHABILITY OF A SEGMENT CHANGES, 
THE SDWS WHICH REFER TO IT MUST HAVE THEIR CACHE CONTROL BITS 
UPDATED 


f TRAILERS - ARE ONLY REMOVED WHEN THE ASSOCIATED SDW IS REVOKED . 
COMPLETELY | 
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SERVICES OF SEGMENT CONTROL 


BOUNDSFAULT HANDLING 
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BOUNDS FAULT HANDLING 


1. PAGE FAULT. PAGE 3 ‘‘CREATED’’ IN MAIN MEMORY 
AS A PAGE OF ZEROS (CALLED A “NEW PAGE”) 


2. BOUNDS FAULT. PROMOTE THE SEGMENT TO THE 16K 
ASTE/PT POOL..CONTINUE REFERENCE 
AS IN CASE #1 


3. BOUNDS FAULT. ERROR: SIGNAL ‘‘out-of-bounds”’ 
CONDITION | 
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SERVICES OF SEGMENT CONTROL 


BOUNDSFAULT HANDLING 


® THE BOUNDSFAULT HANDLER IS THE PROCEDURE "boundsfault", INVOKED BY 
THE FAULT INTERCEPTER MODULE, FIM, WHEN THE BOUNDSFADLT IS DETECTED 
BY THE APPENDING UNIT HARDWARE 


® BASIC STEPS OF BOUNDSFAULT 


f USING THE SEGMENT NUMBER IN THE (SAVED) MACHINE CONDITIONS, FIND 
AND LOCK THE PARENT DIRECTORY, AND FIND THE BRANCH ENTRY 


* LOCK THE AST AND FIND THE  SEGMENT'S ASTE VIA 
get_ptrs $given_segno. IF ATTEMPTED REFERENCE IS BEYOND THE 
MAXIMUM LENGTH (aste.msl) THEN CAUSE "“out_of bounds” TO BE 
SIGNALLED 


] MAKE THE SEGMENT INACCESSIBLE TO USERS BY "CUTTING TRAILERS" 


) TURN ON THE PARENT'S aste.ehs BIT AND CALL get_aste TO OBTAIN A 
LARGER ASTE . 


1 CALL PAGE CONTROL'S pcsmove_page_table TO MOVE ALL ASTE/PT 
INFORMATION TO THE NEW ASTE 


. RETHREAD ALL INFERIOR LIST AND PARENT POINTERS AFFECTED AND TURN 
OFF THE PARENT'S aste.ehs BIT 


. NOTE: IF THE SEGMENT IS A DIRECTORY, ALL FATHER POINTERS OF 
INDOCRIOR SEGMENTS MUST BE UPDATED 
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SERVICES OF SEGMENT CONTROL 


BOUNDSFAULT HANDLING 


J THIS IS THE ONLY REASON FOR THE EXISTENCE OF INFERIOR LIST IN 
THe aor 


] REMOVE THE OLD ASTE FROM THE AST HASH TABLE AND HASH IN THE NEW 
J CALL put_aste TO FREE THE OLD ASTE 


] UNLOCK THE AST AND RETURN A ZERO STATUS CODE TO THE FIM 


Not To Be Reproduced 736 FBOA 


SERVICES OF SEGMENT CONTROL 


SEGMENT DEACTIVATION 


® SEGMENT DEACTIVATION IS PERFORMED BY THE PROCEDURE "deactivate" 


] INPUT: POINTER TO AN ASTE 


@ deactivate MAY BE CALLED BY: 


) get_aste WHEN AN ASTE MUST BE FREED TO MAKE ROOM FOR A NEW 
SEGMENT 


. delete _vtoce AS PART OF SEGMENT DELETING 


) demount_pv IN ORDER TO UPDATE THE VTOCE'S (AND SEGMENTS) OF A 
DISK BEING DEMOUNTED 


® PRINCIPAL STEPS OF deactivate: 
f MAKE THE SEGMENT INACCESSIBLE TO USERS BY "CUTTING TRAILERS" 


) CALL pesScleanup TO REMOVE ALL PAGES OF THE SEGMENT FROM BULK 
STORE AND MAIN MEMORY, WRITING ALL MODIFIED PAGES TO DISK 
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SERVICES OF SEGMENT CONTROL 


SEGMENT DEACTIVATION 


{ UPDATE THE VTOCE FROM THE NOW QUIESCENT ASTE 


1 THREAD THE ASTE OUT OF PARENT'S INFERIOR LIST, AND OUT OF THE 
AST HASH TABLE 


) CALL put_aste TO CLEAR AND INITIALIZE THE ASTE/PT PAIR, AND 
THREAD THE ASTE AT THE HEAD OF THE APPROPRIATE USED LIST 
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SERVICES OF SEGMENT CONTROL 


SUMMARY OF MAJOR SERVICES 


(append) 
J 


UN-WIRED 
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LOCATION DATA 


BRANCH ENTRY DATA BRANCH ENTRY DATA 
e PvID e UID e ENTRY POINT BOUND 
e VTOC INDEX e RING BRACKETS 
@ COMPUTED ACCESS KSTE DATA 
VERIFICATION DATA e DIRECTORY BIT e RING BRACKETS 
e UID INITIATION e DTEM SEGMENT FAULT @ COMPUTED ACCESS 
e UID OF PARENT e BRANCHPOINTER e PRIVILEGED BIT 


© DAMAGED SWITCH (make_known) 


MAINTAINED DATA 
@ SEGMENT NUMBER 


MAINTAINED DATA 
e ADDR OF PAGE TABLE 


ACCESS CONTROL DATA 
e RING BRACKETS 


ae e INITIATED COUNT e@ OUT OF BOUNDS 

. eee ie nee ®@ PRIVILEGED BIT e DIRECTED FAULT BIT 
ETY e UNPAGED BIT 

e ENTRY POINT BOUND e CACHE BIT 


e@ SECURITY BIT 


ATTRIBUTE DATA 

eo NAME(S) 
AUTHOR 
BIT COUNT AUTHOR 
BIT COUNT 
OIRECTORY BIT 
PER PROCESS BIT 
OTEM 


BRANCH ENTRY LIFE CYCLE OF A SEGMENT 


ott 
aE 
ra 
ale 
cows 
[on me 
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BRANCH ENTRY DATA 
UID 
UID OF PARENT 
AIM 
ORIGINAL NAME 
DIRECTORY BIT 
PER PROCESS BIT 
ONZP BIT 


MAINTAINED DATA 


e FILE MAP 

CURRENT LENGTH 

RECORDS USED 

MAX LENGTH 

QUOTA DATA 

USAGE COUNT : 
DTU/OTM/DTC/DTD ~<a 
DUMPER DATA (truncate) 

UID PATH 


VTOCE 
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ACTIVATION 


(activate) 


DEACTIVATION 


{deactivate} 


AST TRICKLE 
(get__aste) 


TRUNCATE 


7-37 


TERMINATE 
(terminate) 


SET FAULT (setfault) - 
BOUNDS FAULT 
(bounds fault) 


VTOCE DATA 

e PVT/VTOCE INDICIES 
uID 
DIRECTORY BIT 
PER PROCESS BIT 
ONZP BIT 
FILE MAP (PT) 
CURRENT LENGTH 
RECORDS USED 
MAX LENGTH 
QUOTA DATA 
USAGE COUNT 
OTU/DTM 


e 
e 
e 
e 
t 
t 
t 
t 
t 
t 
Tt 


MAINTAINED DATA 
e PHU/PHM BITS 
WIRED BIT 
LISTS R_PTR’s 
HASH TABLE R_PTR 
SYS TRAILER R_PTR 
Ls a INFERIOR COUNT 
(peStruncate) EHS/FMC BITS 
; NUMBER OF PAGES 


ASTE/PT 
t MAINTAINED VTOCE DATA 


FSOA 


SERVICES OF SEGMENT CONTROL 


TRUNCATING SEGMENTS 


@ SEGMENT TRUNCATION (IE: PAGE REMOVAL) IS PERFORMED BY THE 
PROCEDURE truncate_vtoce 


f INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT, 
AND A PAGE NUMBER FROM WHICH TO START TRUNCATING 


® truncate_vtoce IS CALLED BY: 


J ‘truncate (DIRECTORY CONTROL) WHO HAS LOCATED THE SEGMENTS BRANCH 
ENTRY AND VALIDATED THE USER'S ACCESS 


1 delete _vtoce (SEGMENT CONTROL) WHO REQUIRES TRUNCATION (FROM 
PAGE #0) PRIOR TO VTOCE DELETION 


® PRINCIPAL STEPS OF truncate_vtoce: 


f iF SEGMENT IS ACTIVE, CALL peStruncate WHO MARKS THE DEVICE 
ADDRESS OF ALL PAGES ABOVE THE PAGE NUMBER SPECIFIED AS "NULLED" 
ADDRESSES (DISCUSSED IN "PAGE CONTROL" TOPIC) 


{ IF SEGMENT IS NOT ACTIVE: 


] READ IN ALL REQUIRED PARTS OF THE VTOCE AND COMPARE UID'S FOR 
CONNECTION FAILURE (RETURN AN ERROR IF SO) 
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SERVICES OF SEGMENT CONTROL 


TRUNCATING SEGMENTS 


J CALL get_pvtxshold_pvtx TO PREVENT A DEMOUNT (IF CALLED BY 
truncate) 


{ COPY ALL ADDRESSES OF PAGES TO BE TRUNCATED FROM THE FILE MAP 
AND REPLACE THEM WITH "NULL" ADDRESSES 


] FABRICATE A NEW VTOCE AND WRITE THE VTOCE °* BACK BY CALLING 
vtoc_man$put_vtoce 


) «IF ANY REAL ADDRESSES WERE COPIED FROM THE FILE MAP, AWAIT 
THE SUCCESSFUL COMPLETION OF THE VTOCE WRITE BY CALLING 
vtoc_manSawait_vtoce 


J CALL pcSdeposit_list TO DEPOSIT (FREE) THESE REAL RECORD 
ADDRESSES 


CALL get_pvtxsrelease pvtx TO AGAIN PERMIT DEMOUNTING ( 
CALLED BY truncate). THIS CREATES AN ENTRY IN THE PV HOLD 
TABLE (SEE TOPIC 6, VOLUME MANAGEMENT) | 
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SERVICES OF SEGMENT CONTROL 


DELETING SEGMENTS 


@® SEGMENT DELETION IS PERFORMED BY THE PROCEDURE delete vtoce 


1 INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT 


® delete _vtoce IS CALLED BY delentry (OF DIRECTORY CONTROL FAME) WHO 
HAS LOCATED THE SEGMENT'S BRANCH ENTRY AND VALIDATED THE USER'S 
ACCESS 


® PRINCIPAL STEPS OF delete_vtoce: 


[ CALL get_pvtxShold_pvtx TO |PREVENT A VOLUME DEMOUNT IN THE 
MIDDLE OF THE DELETION , 


J IF ACTIVE, MAKE THE SEGMENT INACCESSIBLE TO USERS (SEE "ADDRESS 
AND NAME SPACE MANAGEMENT", TOPIC 5) . 


J TRUNCATE THE SEGMENT TO ZERO LENGTH (SEE "TRUNCATING SEGMENTS" 
IN THIS TOPIC), FREEING ALL DISK, BULK STORE, AND MAIN MEMORY 
PAGES OCCUPIED BY THE SEGMENT 


f $F THE SEGMENT IS A DIRECTORY SEGMENT HAVING A QUOTA ACCOUNT, 
CALL THE QUOTA MOVE PRIMITIVE (quotawsSmq) TO RELINQUISH THE 
QUOTA TO ITS SUPERIOR 
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SERVICES OF SEGMENT CONTROL 


DELETING SEGMENTS 


f NOTE: DIRECTORY CONTROL IS RESPONSIBLE FOR DELETING ALL 
INFERIOR SEGMENTS BEFORE REQUESTING DELETION OF THE DIRECTORY 
- ENSURING A CONSISTENT HIERARCHY AND RECOVERY OF ALL 
INFERIOR QUOTA ACCOUNTS 


] «IF THE SEGMENT IS ACTIVE, DEACTIVATE IT, RELEASING ITS ASTE 


) FREE THE VTOCE WITH A CALL TO vtoc_mansfree_vtoce 


] CALL get_pvtxsrelease pvtx TO AGAIN PERMIT VOLUME DEMOUNTING 
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SERVICES OF SEGMENT CONTROL 


OTHER SERVICES 


® OTHER SERVICES PERFORMED BY SEGMENT CONTROL INCLUDE: 


| SEGMENT MOVING 


f REQUIRED WHEN AN ATTEMPT IS MADE TO GROW A SEGMENT AND THERE 
IS NO MORE ROOM ON THE PHYSICAL VOLUME 


| THE ENTIRE SEGMENT MUST BE MOVED TO ANOTHER PV WITHIN THE 
SAME LV --- TRANSPARENT TO THE USER AND DIRECTORY CONTROL 


1 THIS IS THE SINGLE MOST INVOLVED AND ESOTERIC SERVICE OF 
SEGMENT CONTROL 


|] SEMI-PERMANENT ACTIVATION 


f ACTIVATING A SEGMENT INTO AN ASTE OF A GIVEN SIZE AND TURNING - 
ON ITS aste.ehs (DONE BY grab aste) 


[ SERVICES FOR sweep pv 


f LISTING THE VTOC OF A PACK (IE: REPORTING THE PATHNAMES OF 
ALL SEGMENTS OWNING VTOCE'S) 


) THE LOCATING AND DELETING OF ORPHAN VTOCE'S (VTOCE'S NOT 
DESCRIBED IN ANY BRANCH). 


J REBALANCING OR VACATING PACKS VIA DEMAND SEGMENT MOVING 
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SERVICES OF SEGMENT CONTROL 


OTHER SERVICES 


J SERVICES AT DEMOUNT/SHUTDOWN TIME 


a 


{ -DEACTIVATION OF ALL SEGMENTS ON THE VOLUME BEING DEMOUNTED 
AND WRITING OUT THE LABEL, ETC 


ff SERVICES FOR ADDRESS/NAME SPACE MANAGEMENT (SEE TOPIC 4} 


[ DESCRIPTOR SEGMENT (DSEG), PROCESS DATA SEGMENT (PDS) AND 
KNOWN SEGMENT TABLE (KST) MANAGEMENT 


| SEGMENT FAULT HANDLING (seg fault), CREATION, ENTRY HOLDING 
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SEGMENT CONTROL METERS 


file system meters 


© FiLE_SYSTEM_METERS - 
FOR THE FILE SYSTEM 


J ONLY PARTS RELEVANT TO SEGMENT CONTROL 
&@ (PAGE CONTROL) FOR THE REST 


Total metering time 


# 
Activations 1043 
secfault 969 
makeknown ren 
cirecteries G6 
Deactivations 1056 

Demand deactivate 
ettempts 3 
Seg Faults 5089 
fauit 4311 
cal} 769 
activations 969 
we? Bound Faults 220 
oo) SC Setfavits 4454 
. nee TR access L2 
Gor ASTE Trickle 139 
Steps 4279 
Skips 3016 
Ehsrett4 ds de GUTOR 273 
Mem ir Maer weer 1083 
init 1662 
Seerches 0 

ORV 2 " Cleanups 
Se of de tal wae Force writes 3 
rem VO es pages written | 3 
ere Lock AST 184,22 
Rac’ 
Net Te Be Reproducec 


D'SPLAYS MISCELLANEOUS METERING 


- 


0220-02 
JG 
ata we a 
“Ns cares 
1.153 sec 
fa2kl sec §2.905% of ail 
16.251 sec 7.0955 of aii 
12.527 sec G$.204% of ai’ 
1.139 sec 
400.6857 sec 
0.237 sec , 
0.279 sec. B8u.862% cf Seg 
1.564 sec 15.138% of Seg Fac 
1.241 sec 19.6754 of See 
5.466 sec. 
268.!91 msec 
28.633 sec. 0.937% of setfaults 
8.652 sec 
281.040 msec 
c.399 sec 70 .s845 cf Steps 
w.438 sec &.SE5% of Skics 
1.1310 sec 35.909% of Skios 
0O.72L sec 55.1005 of Skips 
0.000 sec. 
1056 1.139 sec. ol OT 
400.857 sec. 
400.857 sec 
0.065 sec 
PROL 


INFORMAT ON 


INCLUDED HERE; SEE TOPIC 


SEGMENT CONTROL METERS 


file system meters 
Lisk pete newk 


Can fe 
AVE /lock % 
AST locked 4.833 msec. ie ae psc ae 
AST lock waiting 1.601 msec. 2.5 —~ By /00 shoud Be < 8 "30 
AST Sizes 4 16 64 256 
Number 1701 601 - 221 74 
Need 819 202 ; 208 34 
Steps 2341 645 1135 i54 
Ave Steps 2.9 See | £.5 
Lap Time(sec) 873. ean <o 23365 577.9 
L 
2a ona ba oie us VS Ap e4uis) \ast 
Fins Lect Bey 186 
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SEGMENT CONTROL METERS 


vtoc buffer meters 


© Vi0C BUFFER METERS - DISPLAYS VTOC BUFFER MANAGER ACTIVITY 


Tota’ metering time: 65:21:12 

Routine # calls ATB (sec) 

get_vtoce 1346752 0.17 

put_vtoce 0 0.00 

alloc_and_pout_vtoce 77378 3.04 

free_vtioce 75064 3.11 

await _vtoce 63376 2.52 

GEL BUFFERS 2732265 0.09 1656952 Hits ' ( £0.6% ef calls) 
wilT S464 37 0.25 946425 TC Waits (100.0% of calls} 


Buffe- Allocation 
# L7B (sec) 


Stecs 1354279 eae Oe 
Skips 276360 9.84 20.6% of steos 

es 240348 C.98 86.2% of skips 

eons Oo ¢.00 o.0% ef skips 

weit 3ES:& 6.11 135.8% of skips 

Disk |/0s 
~ ATBisec} 

Reacs @36S41 0.28 
Writes 548573 0.43 
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SEGMENT CONTROL COMMANDS 


print aste ptp 
Djs Play- Asie 


@® PRINT _ASTE PTP - DISPLAYS INFORMATION FROM AN ASTE 


ASTE for >udd>Multics>Sibert at 115244 in sst_seg 
077550100664 041540056140 165706076310 102401170050 
315015000063 640000044000 446736250032 446736250272 
003720000000 003164000110 006200006000 073770000102 


uid = 102401170050, vtocx = 63 on pvtx 15 (root4 = dskd_1i3) 
max len 205, 6 recs used, 0 in core, cur len 6 (decimal) 
Used 03/18/83 0116.0 est Fri 
Modified 03/18/83 0116.2 est Fri 
Par astep = 76310, Son = 56140, brother = 41540 
Trailer thread = 165706 
Aste for a directory. 
Quota (S D) = (2000 0) 
QUsed (S D) = (1652 72) 


Flags: usedf init seg-tqsw fms 


PAGE PT _ DEVADD 


0 063540200041 63540 
1 063546200041 63546 
2 063547200041 63547 
3. 063550200041 63550 
4 063567200041 63567 
5 063571200041 63571 
6 377020000001 null 

17 =©377020000001 null 
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SEGMENT CONTROL COMMANDS 


dump _vtoce 


® DUMP_VTOCE - READS A VTOCE FROM DISK AND DISPLAYS ITS CONTENTS 


vtoce Sibert (Directory), vtocx 63 on pvtx 15 (root4)-03/18/83 0116.7 est Fri 


Uid = 102401170050, msl/esl/ree = 205 6 6 


Quota (S D) = (2000 0) 


Quota used (S$ D) = (1423 44) . 


Quota received (S D) 
Created 08/16/81 1204. 
Dumped 03/18/83 0106. 
Used 03/17/83 1737. 
Modified 03715783: 21:38:. 


(20 
est 
esc 
est 
est 


wore tl 


Switches: fm_checksum_valid 


Activation information: 


0 000000000000 102401170050 
4 446723404647 001000400000 
10 002617000054 003720000000 
14 000000000000 000652154327 


File map: 


20 063540063546 063547063550 
24 777020777020 777020777020 
S30 TITTIGTITITIG. TI7TT 16777776 


2144 777776777776 777776777776 
Permanent information: 


220 000000000000 000000000000 


230 000000000000 000000000000 
234 126104000547 126104000525 
220° T7TIITIIITIIT? US302Z223 7767 
244 000000000000 000000000000 


260 123151142145 162164040040 
264 040040040040 040040040040 
270 441200557477 135240026001 
274 000000000000 000000000000 
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00 0) 
Sun 
Fri 
Thu 
Tue 


315006006000 
063560063567 
000000000000 
446734634556 


063567063571 
777020777020 
777776777776 


PITIASTT III © 


000000000000 


000000000000 
126104000764 
033023254650 
000000000000 


040040040040 
040040040040 
004370027106 
000000000000 
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446734564570 
003720000000 
015364402005 
445673737671 


777020777020 
777020777020 
TITTIGITITIG 


TELTLOTL ETS 


000000000000 


446736227316 
000000000000 
000000000000 
000000000000 


040040040040 
040040040040 
000000000000 
000000000000 
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TOPIC VIII 


Page Control 


Page 
Page Control OVerviews: sc ee. 2) ee Ue es eh “W.. S. O e e  BEL 
Page Control Terminology «.  %4. <6. -af a tec eae ee, Gas A ewe ee ae a BD 
Page ‘ControlData Bases. 4: 0-6 tee lew eo ae cw a a ew ee Se ae OO 
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COPG Ma sks ie ae es ee OP ee ee er es Re a See 
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Other Data Bases ee ee GR a ea, Se. He SE. RS A ee ee we ES 
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PAGE CONTROL OVERVIEW 


® FUNCTION 


f PAGE CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 
MEMORY TO INCLUDE THE MULTIPLEXING OF MAIN MEMORY FRAMES, AND 
THE MANAGEMENT OF DISK STORAGE 


| ITS TASKS INCLUDE: 


| TRANSFERRING: THE PAGES OF SEGMENTS BETWEEN THE MEMORY 
DEVICES, AND RECORDING THE: LOCATION OF "THE" COPY OF THESE 
PAGES 


) REPORTING THE STATUS AND FILE MAPS OF SEGMENTS TO SEGMENT 


CONTROL 


1 PAGE CONTROL IS LARGELY CODED IN MULTICS ASSEMBLER LANGUAGE 
(ALM) , 


. PAGE CONTROL CAN BE INVOKED EITHER BY SUBROUTINE CALLS OR BY 
PAGE FAULTS 


| THERE ARE -NO EXPLICIT USER INTERFACES TO PAGE CONTROL 
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PAGE CONTROL OVERVIEW 


® BASIC PHILOSOPHY 


[tes] 


OF ALL THE SEGMENTS ACTIVE AT A GIVEN TIME, ONLY A SMALL SUBSET 
OF THEIR TOTAL PAGES WILL BE REQUIRED FOR ACCESSING 


f PAGES WILL BE READ INTO MAIN MEMORY AS THEY ARE REQUIRED 


] THE READING OF A PAGE INTO MAIN MEMORY WILL (PROBABLY) REQUIRE 
THE EVICTION OF A PREVIOUSLY REQUIRED PAGE 


[| THE CHOICE OF A PAGE FOR EVICTION WILL BE BASED ESSENTIALLY UPON 
A “LEAST RECENTLY USED” CRITERIA 


f AN EVICTED PAGE NEED BE WRITTEN BACK TO DISK ONLY IF IT WAS 
MODIFIED DURING ITS RESIDENCY IN MAIN MEMORY . 


® MAJOR DATA BASES 


f PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM. PROVIDED BY 
VOLUME MANAGEMENT 


f PHYSICAL VOLUME TABLE ENTRY (PVTE) - ONE PER DISK DRIVE 
CONFIGURED 


f EACH PVTE CONTAINS: 


f THE DEVICE ID (DISK DRIVE ID) AND THE ID OF THE PHYSICAL 
VOLUME (DISK PACK) CURRENTLY MOUNTED 
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PAGE CONTROL OVERVIEW 


f THE NUMBER OF RECORDS LEFT UNALLOCATED ON THE PHYSICAL 
VOLUME, POINTER TO THE RECORD STOCK, ETC 


) RECORD STOCKS - ONE PER MOUNTED PHYSICAL VOLUME, PROVIDED BY 
VOLUME MANAGEMENT ' 


) CONTAINS AN IN-MEMORY CACHE OF THE .IN-USE STATUS OF RECORDS 
ON -THE VOLUME, FROM THE VOLUME MAP, USED WHEN ALLOCATING OR 
FREEING PAGES ae 


J ACCESSED BY A COMPLEX MECHANISM WHICH USES NORMAL PAGE I/O 
BUT HAS A PROTOCOL TO ENSURE SYNCHRONIZATION OF DISK CONTENTS 
AND RECORD STOCK CONTENTS 


] SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM. SHARED WITH 
SEGMENT CONTROL. CONTAINS THE FOLLOWING FIVE DATA BASES USED BY 
PAGE CONTROL: 

J SYSTEM SEGMENT TABLE (SST) HEADER - ONE PER SYSTEM 


] CONTAINS A LARGE NUMBER OF COUNTERS AND POINTERS VITAL TO 
THE MAINTENANCE AND METERING OF THE STORAGE SYSTEM 


J CONTAINS LOCKWORDS USED TO SYNCHRONIZE PAGE CONTROL AND 
SEGMENT CONTROL OPERATIONS 
1 CORE MAP - THE core_map SEGMENT - ONE PER SYSTEM 


f CORE MAP ENTRY (CME) - ONE PER FRAME (1024 WORDS) OF 
CONFIGURED MAIN MEMORY 


f EACH CME REPRESENTS A FRAME OF MAIN MEMORY AND IDENTIFIES 
THE CURRENT OCCUPANT OF THAT FRAME 
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PAGE CONTROL OVERVIEW 


NOT PART OF THE SST SEGMENT ANY MORE, BUT LOGICALLY PART 
OF ‘THE <SST 


tL — ] 


ACTIVE SEGMENT TABLE (AST) - ONE PER SYSTEM 
] ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER ACTIVE SEGMENT 
J LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 


) PAGE TABLES (PT) - ONE PER ACTIVE SEGMENT, THE OTHER HALF OF 
EACH ASTE 


) PAGE TABLE WORD (PAGE PTW) - EITHER 4, 16, 64, OR 256 PER 
PAGE TABLE 


J EACH PTW DEFINES THE CURRENT LOCATION OF A PAGE OF THE 
SEGMENT: DISK, MAIN MEMORY ADDRESS, OR NULL 
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PAGING: 


CORE: 


PAGE FAULT: 


PAGE CONTROL TERMINOLOGY 


THE PROCESS OF TRANSFERRING PAGES OF DATA BETWEEN DISK 
STORAGE AND MAIN MEMORY (CORE) TO ACHIEVE THE EFFECT OF 
ALL DATA BEING IN MEMORY ALL THE TIME 


AN OBSOLETE TERM USED FREQUENTLY TO REFER TO MAIN 
MEMORY (WHICH IS MOS TECHNOLOGY, NOT CORE TECHNOLOGY ) 


AN EXCEPTION CONDITION DETECTED BY THE PROCESSOR 
HARDWARE (IN THE APPENDING UNIT) WHEN AN ATTEMPT IS 
MADE TO USE A PTW SPECIFYING THAT ITS PAGE IS NOT IN 
MAIN MEMORY 
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PAGE CONTROL DATA BASES 


PAGE TABLES 


WORDS: 


Ose pPoOR 


(PTW.INCL.PL 1: 


A 16K PAGE TABLE (PT) 


IMMEDIATELY FOLLOWS AN ASTE (ABOVE) - ONE PER ACTIVE SEGMENT 
COMES IN 4. 16. 64 AND 256K FLAVORS 


® THE PAGE TABLES (PT'S) ARE HARDCORE (SST), UNPAGED, DATA BASES EACH 
CONSISTING OF AN ARRAY OF PAGE TABLE WORDS (PTW'S) 


J ONE PAGE TABLE PER ACTIVE SEGMENT 


2 4&, 16, 64, OR 256 PTW PER PAGE TABLE 
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PAGE CONTROL DATA BASES 


PAGE TABLES 


® ALL PAGE TABLES ARE ASSOCIATED WITH, AND IMMEDIATELY FOLLOW AN ASTE 
IN THE AST REGION OF THE SST 


® EACH PTW DESCRIBES THE STATUS OF ONE PAGE OF THE SEGMENT CURRENTLY 
IN POSSESSION OF THE ASSOCIATED ASTE, INCLUDING: 


J THE DEVICE ADDRESS OF THE COPY OF THE PAGE 


) PTW VALID INDICATOR AND FAULT NUMBER (FAULT #1) 


@® THE ADDRESS PORTION OF EACH PTW IS INITIALIZED FROM THE SEGMENT'S 
VTOCE FILE MAP AT SEGMENT ACTIVATION TIME 
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DISK PACK 


te fee, ee ee ee 
igs ] 
( 
»  PAGE2 \ 


J 1000n. 0000... | 
00 0000.. 
1 wn.000000-.. 
j 000_n~__ 000. | 
pg. 004 CO0C A 90 


“GHOST” PAGE 
OF ZEROES 


| 
| 
at 


Sones 


PAGE TABLE DEVICE ADDRESSES 


SaTaVL govd 


DISK RECORD 
NUMBER | 


NULL 
ADDRESS 


SaSVd YLYA TIOMLNOO Fovd 


MAIN 
MEMORY 
ADDRESS 


A 4K PAGE TABLE 


MAIN MEMORY 


PAGE CONTROL DATA BASES 


CORE MAP 


FORWARD REL POINTER BACKWARD REL PTR 


PTW OFFSET IN SST A STE OFFSET IN SST 
PIN COUNTER PAGE SYNCHRONIZATION REL PTR 


oe CORE MAP ENTRY (CME) sa ara 
A HARDCORE DATABASE, LOCATED IN THE 


CORE _MAP SEGMENT. ONE CME PER CONFIGURED 
FRAME OF MAIN MEMORY 


@ THE CORE MAP IS A PERMANENTLY WIRED, UNPAGED, SEGMENT CONTAINING AN 
ARRAY OF CORE MAP ENTRIES (CME'S) 


“J ONE CORE MAP PER SYSTEM 


) ONE CME PER ADDRESSABLE MAIN MEMORY FRAME 


f IF THE CONFIGURATION HAS HOLES IN THE MEMORY ADDRESS 
ASSIGNMENTS, OR MEMORIES WHICH ARE TURNED OFF, THOSE CMES ARE 
PRESENT ANYWAY (BUT UNUSED) (0 TO HIGHEST FRAME ADDRESS) 
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PAGE CONTROL DATA BASES 


CORE MAP 


® EACH CME DESCRIBES THE STATUS OF ONE PAGE FRAME IN MAIN MEMORY 
INCLUDING: 


] THE DISK ADDRESS OF THE PAGE CURRENTLY OCCUPYING THE FRAME 
J ADDRESS OF THE ASTE AND PTW OF THE OCCUPANT 


J FLAGS INDICATING VARIOUS STATES AND PROPERTIES OF THE FRAME AND 


ITS OCCUPANT SUCH AS I/O IN PROGRESS, NOTIFICATION REQUESTED, 
AND PIN WEIGHT 


® THE CME'S ARE KEPT IN A DOUBLE-THREADED CIRCULAR LIST POINTED TO BY 
sst.usedp 


o 
THE LIST 


f CME'S FOR FRAMES CONFIGURED BUT NOT PHYSICALLY PRESENT ARE ALSO 
THREADED OUT BUT WITH THREAD WORD "777777777777" OCTAL 


] THE REMAINING CME'S REPRESENT MAIN MEMORY FRAMES ACTIVELY IN USE 
- AND SUBJECT TO EVICTION BY THE PAGE REPLACEMENT ALGORITHM 
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PAGE CONTROL DATA BASES 


SYSTEM SEGMENT TABLE (SST) HEADER 


@ THE FIRST. 512 WORDS OF THE SST IS CALLED THE SST HEADER AND 
CONTAINS: 


| A LARGE NUMBER OF GLOBAL VARIABLES VITAL TO THE OPERATION OF THE 
STORAGE SYSTEM AND ITS SUBSYSTEMS 


f NUMEROUS CELLS USED TO METER THE STORAGE SYSTEM 


® AMONG THOSE OF INTEREST TO PAGE CONTROL ARE THE FOLLOWING: 


) GLOBAL VARIABLES: 
) PAGE TABLE LOCK (sst.ptl) 


| NUMBER OF MAIN MEMORY FRAMES AVAILABLE FOR PAGING ACTIVITIES 
(sst.nused) AND NUMBER WIRED (sst.wired) 


. POINTERS TO THE BASE OF THE CME ARRAY AND TO THE CME OF THE 
"BEST" CANDIDATE PAGE FOR REPLACEMENT 


] PVT INDEX OF THE RPV (USED DURING INITIALIZATION) 


| METERS 


1 THRASHING, POST-PURGE-TIME, PAGE FAULTS ON DIRECTORIES, RING 
0 PAGE FAULTS, LOOP LOCK TIME, SEGMENT MOVES 
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PAGE CONTROL DATA BASES 


SYSTEM SEGMENT TABLE (SST) HEADER 


| PAGING METERS REPORTED BY file_system_meters SUCH AS STEPS, 
NEEDS, CEILING, SKIPS 


ro) 
oO 
yy 
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PAGE CONTROL DATA BASES 


OTHER DATA BASES 


@® ALTHOUGH BASICALLY DATA BASES OF VOLUME MANAGEMENT, THE FOLLOWING 
CONTAIN INFORMATION REQUIRED BY PAGE CONTROL (AS INDICATED) 


® PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM 
| INFORMATION REQUIRED BY THE DISK DIM FOR I/O 
J INFORMATION USED BY THE DISK RECORD ALLOCATOR/DEALLOCATOR 
(free_store) SUCH AS: 
] THE NUMBER OF UNALLOCATED RECORDS LEFT ON THE VOLUME 


) THE LOCATION OF THE RECORD STOCK FOR THE VOLUME 


® RECORD STOCKS 
J RECORD STOCKS ARE KEPT IN A WIRED SEGMENT: stock _seg 
) THE RECORD STOCK FOR A VOLUME IS A LIST OF SOME OF THE RECORDS 
WHICH ARE FREE ON THE VOLUME 


) WHEN THERE ARE NO MORE ENTRIES AVAILABLE IN THE STOCK, IT IS 
UPDATED FROM THE VOLUME MAP 
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PAGE CONTROL DATA BASES 


OTHER DATA BASES 
.f IF THE STOCK BECOMES FULL, SOME OF ITS ENTRIES ARE UPDATED TO 
THE VOLUME MAP AND REMOVED FROM THE STOCK 


[ A COMPLEX MECHANISM (SEE volmap.alm, volmap_page.alm) MAKES 
IT POSSIBLE TO REFERENCE THE VOLUME MAP PAGES WHILE 
SATISFYING A PAGE FAULT 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING 


® WITHIN ANY DEMAND PAGING ENVIRONMENT THE CHOICE OF WHICH PAGE TO 
EVICT IS CRUCIAL TO SYSTEM PERFORMANCE 


® ONE OF THE BETTER CHOICES FOR EVICTION IS THE "LEAST RECENTLY USED" 
PAGE....OR (BECAUSE OF EFFICIENCY), THE "LEAST RECENTLY NOTICED AS 
BEING USED" PAGE. 


@® THE MULTICS PAGE REPLACEMENT ALGORITHM (PRA), KNOWN IN THE 
LITERATURE AS THE "CLOCK" ALGORITHM WAS ONE OF THE FIRST EVER TO BE 
IMPLEMENTED 


@ THE VERSION AS IT EXISTS TODAY IS A DIRECT DESCENDANT OF Corbato's 
ORIGINAL ALGORITHM (SEE SECTION 5 OF THE "MULTICS STORAGE SYSTEM 
PLM", AN61, FOR A BIBLIOGRAPHY) . 


® PAGES ARE KEPT IN A CIRCULAR LIST, THE CORE USED LIST, IMPLEMENTED 
BY THE DOUBLY THREADED CME'S 


® A POINTER, MAINTAINED IN THE SST, (sst.usedp) POINTS TO THE LOGICAL 
HEAD OF THIS LIST AS FOLLOWS: 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING ox 
oy oO 


\ WRITING* 


“THE PURIFIER” 


SEN 
PTE FH red so0 
jefe) 


* SKIP USED =1 
SKIP MOD = 1 
STEPS =3 


THE CLOCK ALGORITHM 


1. THE “REPLACER” SEARCHES FOR THE FIRST PAGE WHICH IS NEITHER WIRED NOR 
MODIFIED, AND HAS NOT BEEN USED SINCE LAST INSPECTED, MAKING THAT PAGE 
IMMEDIATELY AVAILABLE TO THE REQUESTOR. | 


2. THE “PURIFIER” THEN CATCHES UP INITIATING WRITES FOR ALL “NOT USED-BUT 
MODIFIED” PAGES PASSED OVER BY THE “REPLACER” AND TURNING OFF THE USED 
FLAG FOR ALL USED PAGES. 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING 


PAGE FAULT HANDING IS THE MOST VISIBLE AND CRUCIAL SERVICE OF PAGE 
CONTROL 


A PAGE FAULT OCCURS WHEN A USER REFERENCES A PAGE OF SOME SEGMENT 
THAT IS NOT IN MAIN MEMORY 


Jf OR MORE SPECIFICALLY: HARDWARE ATTEMPTS TO USE A PTW THAT 
INDICATES ITS PAGE IS NOT IN THE MAIN MEMORY 


PAGE FAULT HANDLING IS IMPLEMENTED IN THE ALM PROGRAM page fault 
WHICH IS INVOKED DIRECTLY BY THE FAULT VECTOR CODE (page_ fault LS 


THE FAULT Ip TT ME \ 
491 SAUL INTERCEPTOR FOR PAGE FAULTS ) 


THE PRINCIPAL STEPS OF page fault ARE: 


) SAVE ALL: MACHINE CONDITIONS, MASK AGAINST INTERRUPTS, AND 
ESTABLISH A STACK FRAME ON THE BASE OF THE PROCESSOR DATA 
SEGMENT (PRDS), WHICH IS USED AS THE STACK FOR INTERRUPTS AND 
PAGE FAULTS 


) CHECK FOR ILLEGAL CONDITIONS AND CRASH IF SO 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING 


f ATTEMPT TO LOCK THE PAGE TABLE LOCK (sst.ptl) AND WAIT IF 
UNSUCCESSFUL 


J LOCATE THE RESPONSIBLE PTW AND ITS ASTE. THIS IS OFTEN THE MOST 
DIFFICULT TASK 


f «IT IS DIFFICULT BECAUSE IT REQUIRES FETCHING THE SDW FROM THE 
DSEG, WHICH IS, ITSELF, PAGED, AND NOT GUARANTEED TO BE IN 
MEMORY 


Jf CHECK FOR TWO WINDOW SITUATIONS INVOLVING SOME OTHER PROCESS 
HANDLING A PAGE FAULT FOR THE SAME PAGE: 


J IF PAGE IS NOW IN, THEN UNLOCK THE LOCK AND RESTART THE 
MACHINE CONDITIONS 


J «IF PAGE IS BEING READ IN NOW, DEVELOP THE WAIT EVENT FOR THE 
PTW AND SKIP THE NEXT THREE STEPS 


] INVOKE read _page TO FIND THE LEAST RECENTLY (NOTICED AS BEING) 
USED MAIN MEMORY FRAME, BEGIN THE PAGE-READING FUNCTION, AND 
DEVELOP THE WAIT EVENT 


J EXECUTE THE REPLACEMENT ALGORITHM'S WRITE-BEHIND (PURIFIER). 
FUNCTION, CAUSING PASSED OVER WRITE REQUESTS TO BE QUEUED 


] METER THE PAGE FAULT TO INCLUDE: TIME SPENT; MAIN MEMORY USAGE 
OF THIS PROCESS; RING ZERO, DIRECTORY, AND PER-PROCESS FAULTS 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING 


J TRANSFER TO THE TRAFFIC CONTROLLER, WHO PLACES THE PROCESS IN 
THE WAIT STATE, UNLOCKS THE PAGE TABLE LOCK, AND ABANDONS THE 
ENVIRONMENT (SEE "TRAFFIC CONTROL”, TOPIC 10) 


@ WHEN THE PAGE READING I/O IS COMPLETE, THE EVENT WILL BE POSTED. 
THE WAITING PROCESS WILL BE GIVEN THE PROCESSOR AGAIN AND TRAFFIC 
CONTROLLER WILL TRANSFER THE FAULTING PROCESS TO 
page _faultSwait_return TO RESTART THE MACHINE CONDITIONS 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING 


PHYSICAL VOLUME 


LOGICAL VIEW 
OF SEGMENT A 
(CL = 3) 
(RU = 2) 


I 

CME 
5614 1 
MMF | 

5614 . I 

| 


CME 
3702 
MMF 
3702 
ASSOCIATED 
CORE MAP MAIN MEMORY 
ENTRIES FRAMES 


PAGE FAULT SCENARIO 


SCENE 1: AFTER SEGMENT ACTIVATION 


ASTE/PT PAIR FREED AND ALLOCATED TO SEGMENT A 
VTOCE’S ACTIVATION DATA COPIED INTO ASTE 
VTOCE’S FILE MAP DATA COPIED INTO PTW 


WON 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING 


PHYSICAL VOLUME 
LOGICAL VIEW SEGMENT A’s 
OF SEGMENT A VTOCE FILE MAP 
(CL = 3) 
(RU = 2) 


ASTE 


Le 


J 
I 
I 
! 
! 
I 


SEGMENT A’s 
PAGE TABLE 


PTW # 2RPTR 


ASSOCIATED 
CORE MAP MAIN MEMORY 


ENTRIES FRAMES 


PAGE FAULT SCENARIO— 


SCENE 2: AFTER PAGE FAULT ON PAGE NO.2 


1. FRAME 3702 FREED AND ALLOCATED TO PAGE NO. 2 

2. PAGE NO. 2COPIED INTO FRAME 3702 

3. ADDRESS IN PTW NO. 2 COPIED TO CME 3702 

4. ADDRESS IN PTW NO. 2 REPLACED WITH MAIN MEMORY ADDRESS 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING 


0 
1 
1 2 
3 
7 4 
5 
3 
PHYSICAL VOLUME 
LOGICAL VIEW SEGMENT A’s 
OF SEGMENT A VTOCE FILE MAP 
(CL = 3) 
(RU = 2) 
Pop se eae ne cee ae sad 


PTW + 1RPTR 


eae cee ! 
Laat] : ae 
| 
en | 
i 
I, 17 35 
rR 1705 | 4| | 0 


Part Dr AADrnnnnh 
NV 
av vou POP Np Neate 
0 7 35 DAR LMN 
| | DIOR ee ADA ee 
www a 
02 AANA rn SEGMENT A's 
PRANMAANADNMA PAGE TABLE 
MMF 
Pp DV ed \ Sarl erence 
ASSOCIATED 
CORE MAP MAIN MEMORY 
ENTRIES FRAMES 


PAGE FAULT SCENARIO 


SCENE 3: AFTER PAGE FAULT ON PAGE NO. 1 


. FRAME 5614 FREED AND ALLOCATED TO PAGE NO. 1 

. FRAME 5614 ZEROED BECAUSE OF PTW NO.1's NULL ADDRESS 

. RECORD 2103 ALLOCATED TO PAGE NO.1 

. ADDRESS FOR RECORD 2103 WRITTEN INTO CME 5614 AS A NULLED ADDRE 


f&# WH a 
2) 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING 
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MANA ath Manan 
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PHYSICAL VOLUME 


LOGICAL VIEW 
OF SEGMENT A 
{CL = 3) 
(RU = 2) 
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aA" ee 
oat ewen aw 
AMMA 
MAAN ADANAMA, 
RP Le MN Act een MMF 
Ab eect la aa 3702 
ASSOCIATED 
CORE MAP MAIN MEMORY 
ENTRIES FRAMES 


PAGE FAULT SCENARIO 


SCENE 4A: PAGE NO.1 (UNMODIFIED) EVICTED FROM MAIN MEMORY 


1. NULLED ADDRESS IN CME 5614 COPIED TO PTW NO.1 
2. CME 5614 FREED 
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3 
PHYSICAL VOLUME 
SEGMENT A’s 
Ww 
OF SEGMENT A | VTOCE FILE MAP 
(CL = 3) 
(RU = 2) 


MMF 
5614 


SEGMENT A's 
PAGE TABLE 
MMF 
3702 


ASSOCIATED 
CORE MAP MAIN MEMORY 


ENTRIES FRAMES 


PAGE FAULT SCENARIO 


SCENE 5A: AFTER SEGMENT DEACTIVATION 


PAGE NO. 2 EVICTED FROM MAIN MEMORY AFTER ADDRESS IN CME 3702 COPIED TO PTW NO. 2 
PTW ADDRESSES WRITTEN TO VTOCE FILE MAP WITH NULLED ADDRESS IN PTW NO. 1 
CONVERTED TO A NULL ADDRESS 

RECORD 2103 FREED 

ASTE/PT PAIR FREED 


Pw N= 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING 


PHYSICAL VOLUME . 
LOGICAL VIEW SEGMENT A‘’s 
OF SEGMENT A VTOCE FILE MAP 
(CL = 3) 
(RU =3) 


: eeeeeeee ee 
sa a a 


ASTE 


= 
= 
n 


Li] ovens 
PAGE TABLE 


PTW +¢2RPTR 


ASSOCIATED 
CORE MAP MAIN MEMORY 
ENTRIES FRAMES 


PAGE FAULT SCENARIO 


SCENE 4B: PAGE NO.1(MODIFIED) EVICTED FROM MAIN MEMORY 
(AND DISK !/O KNOWN TO BE COMPLETE) 


1. FRAME 5614 WRITTEN TO RECORD 2103 


2. NULLED ADDRESS IN CME 5614 RESURRECTED AND COPIED TO PTW NO. 1 
3. CME 5614 FREED 
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SERVICES OF PAGE CONTROL 


PAGE FAULT HANDLING 


0 
1 
1 2 
3 
: 4 
5 
3 
PHYSICAL VOLUME 
SEGMENT A’s 
OGICAL VIEW 
oF SEGMENT A VTOCE FILE MAP 
(CL = 3) 
(RU =3) 


0 17 35 . 
r | 
] ! 
CME } ASTE J 
5614 i; i 
MMF | H 
I } 


3702 PAGE TABLE 
3702 

ASSOCIATED 

CORE MAP MAIN MEMORY 

ENTRIES FRAMES 

SCENE 5B: AFTER SEGMENT DEACTIVATION 
1. PAGE NO. 2 EVICTED FROM MAIN MEMORY 
2. PTW ADDRESSES WRITTEN TO VTOCE FILE MAP 
3. ASTE/PT PAIR FREED 
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SERVICES OF PAGE CONTROL ~ 


POST PURGING 


® POST PURGING IS PERFORMED BY THE PROCEDURE post_purge 


® POST PURGING IS AN OPTIONAL SERVICE USED TO OPTIMIZE THE PAGE 
REPLACEMENT ALGORITHM 


@ POST PURGING: 


J FAVORS THE REPLACING OF PAGES USED BY A PROCESS WHICH HAS JUST 
LOST ELIGIBILITY (SEE "TRAFFIC CONTROL", TOPIC 9) 


f IS A WORK CLASS SETTABLE ATTRIBUTE 


® POST PURGING IS LARGELY USELESS TODAY, BECAUSE MAIN MEMORY SIZE IS 
SO MUCH GREATER 
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PAGE CONTROL METERS 


file system meters 


® FILE SYSTEM_METERS - DISPLAYS MISCELLANEOUS METERING INFORMATION 
FOR THE FILE SYSTEM 


J ONLY PARTS RELEVANT TO PAGE CONTROL INCLUDED HERE; SEE TOPIC 7 
(SEGMENT CONTROL) FOR THE REST 


Total metering time 0:20:02 
fers 
@ . Oat # ATB i ie 
OXo We 7 : a oe AY 
Needc 62654 19.194 msec. 
rte Ring 0 faults 16.639 & foe 
pen PDIR faults 50.607 % Wy T0 T8 cons. 
UE, 2 faults 21.556 % ° set bor SG? 
wee DIR faults— vedio! eyrtss 7.645 % 
a Co New Pages Pare fatty for NWN Roes 14,661 % 
Ue Volmap_seg 0 0.000 msec. ek 
coo zero pages 770 1561.779 msece wer 9 ONT FeO Page 
= Laps 105 11.453 sec. oremd chain Cece ratostier 
oO (Bteps 361483 3.327 ‘msec. | 
low Skip 322555 3.728 msec. 89.231% of Steps 
Then yashin wired 11057 108.761 msec. 3.428% of Skip 
fone WAS used 109719 10.960 msec. 34.016% of Skip 
ans? mod 140336 8.569 msec. 43.508% of Skip 
) pA - Ee Pine 37747 31.884 msec. 11.693% of Skip 
ce , cl a ia 23726 50.686 msec. 7.356% of Skip 
. sig * 
aioe! 3419 pages, 139 wired. 
cipl Average steps operat 
Canete ee Cert Cer 
An w 
fauot Pages vised fy 
yailinG rer To STAY 
In Memory lOnnor, 
Set Fer werk Clases, 
‘ ¢: pF used S57 S20 
en ba ee ae Then \ook 
Sees - © AT Sins, 
bh Nou decavtt a 5 aes, kt ee 
C Nknee Ret Bim eFReeT fen wort Served 
by tTWwl I Vr ow Qxtes 1 4 °S 
THY FR VEC the 
CAI TIAL aor Rin WaT, 
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TOPIC Iz 


Traffic Control 


Page 
Tratiic iCONELOL. OVELVIGW 6: o> ie we. tee en Se Ss wee eS: ee we % es Bae BRD 
Trarric. Control Terminology. e286 Gm Med tae Ss eR; ee ae SS SS 
Trattic Control Data Bases « 6: 4 a a ee ds ww) ewe ele ee ee we OSS 
$6 datas a. « « . Seite! 4. delay eo ey Ge, oe es eA a OS 
Services of Traffic Control. a a. We See WR ORE Beles A Ce ae ee ee. BOS 
Wait Locks ..... Se et Sar tt cette: WA er eu) es a Jee te Be 
Processor Multiplexing Bm eh et Sel ln WS de Ss Ss yet he Ae BS > Be SS 
TratticControl..Merers ~6.- 4 63h) 76 ao. were cate Be es A eS So tw, ALS 
EOtal time MEtersi: «es, Sle eB A oe a ee Se BL er ds EES 
Erattic- Control. MECSrS! sk hme: ee. oe ce ew ee ee ce, we LD 
traffic control OUGUS 62. er 9, ek Be ee a SE at SY a ee es we ee 
work _elass PMG ECCS o's <a aie Soe Sree ae Se Ta Se a STS 
respons. meters: ge i}. Se Oe Ae ee Dee RS Saw SG e2e 
POST ‘DUrge Meters. we. 6) eS ae lee el ee a we ee ee a eS Ee ce, RSE 
Trattic ‘Control ‘CommanGs:«.). 2) «si Siew oees e) ae e R a  , ST 
print -EUNING Parameters. 2. ow. Geka er Bee ee LT 
DEINE ape CNC SY so ude ae ene, eee NASA: ey ee cee Be ee es oe FASS 
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TRAFFIC CONTROL OVERVIEW 


® FUNCTION 


) TRAFFIC CONTROL (OR THE "TRAFFIC CONTROLLER") IS RESPONSIBLE FOR 
MANAGING THE ASSIGNMENT OF PHYSICAL PROCESSORS TO MULTICS 
PROCESSES AND IMPLEMENTING THE SYSTEM'S WAIT/NOTIFY AND 
INTERPROCESS COMMUNICATION PRIMITIVES 


) THE FUNCTIONS ASSUMED BY THE TRAFFIC CONTROLLER ARE KNOWN AS 
MULTI PROGRAMMING, MULTI PROCESSING, SCHEDULING, DISPATCHING, 
PROCESSOR MANAGEMENT, AND INTERPROCESS COMMUNICATION. 


J ITS MAJOR FUNCTION IS ALLOWING PROCESSES TO AWAIT THE COMPLETION 
OF FILE SYSTEM OPERATIONS, SUCH AS PAGE 1/0 


] TRAFFIC CONTROL CAN BE INVOKED BY SUBROUTINE CALLS AND 
INTERRUPTS 


) THERE ARE NO IMPORTANT USER SUBROUTINE INTERFACES, BUT THERE ARE 
PRIVILEGED SUBROUTINE INTERFACES FOR PROCESS CREATION, 
ADJUSTMENT OF SCHEDULING PARAMETERS, ETC. 


@ MAJOR DATA BASES 


] TC_DATA SEGMENT - ONE PER SYSTEM. CONTAINS THE FOLLOWING FOUR 
DATA BASES: . 


] TC_DATA HEADER - ONE PER SYSTEM 


| CONTAINS VARIOUS METERS, COUNTERS AND POINTERS USED BY THE 
TRAFFIC CONTROLLER 
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TRAFFIC CONTROL OVERVIEW 


| ACTIVE PROCESS TABLE (APT) - ONE PER SYSTEM 


f ACTIVE PROCESS TABLE ENTRY (APTE) - ONE OCCUPIED PER 
ACTIVE PROCESS (TOTAL NUMBER IS DETERMINED BY CONFIG DECK) 


) EACH APTE CONTAINS VARIOUS ATTRIBUTES OF AN ACTIVE PROCESS 
INCLUDING THE PROCESS ID, STATE, THE VALUE OF ITS 
DESCRIPTOR BASE REGISTER (DBR), SCHEDULING PARAMETERS, AND 
A POINTER TO THE PROCESS'S ITT ENTRIES > 
| THE APTE CONTAINS ALL INFORMATION THE SUPERVISOR NEEDS TO 
KNOW ABOUT A PROCESS WHEN THE PROCESS IS NOT RUNNING 
| INTERPROCESS TRANSMISSION TABLE (ITT) - ONE PER SYSTEM 
) ITT ENTRY - ONE OCCUPIED PER OUTSTANDING IPC WAKEUP 
. A QUEUE FOR TEMPORARILY STORING IPC WAKEUP INFORMATION 
(CHANNEL NAME, RANDOM DATA, PROCESS ID, ETC) 
[ WORK CLASS TABLE (WCT) - ONE PER SYSTEM 
[ WORK CLASS TABLE ENTRY (WCTE) - ONE PER WORKCLASS 


J EACH WCTE CONTAINS ADMINISTRATOR DEFINED PARAMETERS OF THE 
WORKCLASS, VARIOUS METERS AND POINTERS 
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TRAFFIC CONTROL TERMINOLOGY 


PROCESS: 
AN ADDRESS SPACE AND AN EXECUTION POINT WITHIN THAT 
ADDRESS SPACE 
MULTI PROGRAMMING: 
PERTAINING TO THE CONCURRENT EXECUTION OF TWO OR MORE 
PROGRAMS BY INTERLEAVING THEIR EXECUTION 
MULTI PROCESSING: 
PERTAINING TO THE SIMULTANEOUS EXECUTION OF TWO OR MORE 
PROGRAMS BY A MULTI PROCESSOR SYSTEM (PARALLEL 
PROCESSING) 
O Svanie QrocesS v5 tb). SON. SENET Then | Py, 
ELIGIBLE: 


AN ADJECTIVE DESCRIBING 


THOSE PROCESSES ACTIVELY 
COMPETING FOR A PROCESSOR. ALL PROCESSES ARE SITHER 
ELIGIBLE OR INELIGIBLE 


F oly x ale 
phoma S 
We SCHEDULING: 

Y 


PERTAINS TO THE ACT OF CHOSING AND PROMOTING AN 
¢ 
EN aos "INELIGIBLE" PROCESS TO "ELIGIBLE" STATUS 
co 


C4: yate 
DISPATCHING: “errr >*° 


IN THE "RUNNING" 


PERTAINS. TO THE ACT OF CHOSING AND PLACING AN ELIGIBLE 
PROCESS STATE (IB: 
INSTRUCTIONS ON A PROCESSOR) 


EXECUTING 
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TRAFFIC CONTROL TERMINOLOGY 


WORK CLASS: A WELL DEFINED SET OF USERS (USUALLY CONSISTING 


OF ONE OR MORE PROJECTS) HAVING COMMON PERFORMANCE 
PARAMETERS. THE USER COMMUNITY MAY BE DIVIDED INTO NO 
MORE THAN i6 WORK CLASSES 


wer 
WORKING SET: Corleclian of QAeps ees in Cre AT one Imrie, Wh They Poy fr. 


THE SET OF PAGES A PROCESS TOUCHES DURING A GIVEN 
INTERVAL. THE SIZE OF A CURRENT WORKING SET IS 
PREDICTIVE OF FUTURE MEMORY REQUIREMENTS : 


Proll} ec § 


WOK Lor ser. = 
premory Une tS seat “Yeo vA THUNK STON S 


Qa urroced WSt Cale ar Tu ATTICS 


\o oY a) Qe Ts wa Ry olecses © Sec, Wit ced AN renee 
Jame SE wile 
“CO “Tes > ANWo T af Ve Py fo Can VIC 
Ud an bee c r t 
Ton Your @(9/8l€. Onte you Use «P Your "9 ‘bio 


on C Pu Val wiixe. 


Deemer = FrQ Process 


vy 4.05 (T ue 


Oven + 
V 6 ; Love, The y Need a 
CPG: ere Died ese Anne a es, 5 
2 Sn") Cova 7 aor 
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TRAFFIC CONTROL DATA BASES 


TC DATA 


tc_data HEADER 


WORK CLASS TABLE (WCT) 
(0:16 ) 


ACTIVE PROCESS TABLE (APT) 
( 0:CONFIGURED ) 


INTERPROCESS TRANSMISSION TABLE (ITT) 
( 0:CONFIGURED ) 


TC_DATA 


A WIRED DATA BASE — ONE PER SYSTEM 
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TRAFFIC CONTROL DATA BASES 


TC DATA 


BACKWARD R_ PTR 


i G i$ EXECUTION STATE 


IPC EVENT THREAD 


IPS MESSAGEIS) 
R_PTR TO ASTE OF POS R_PTR TO ASTE OF DSEG 
R_PTR TO ASTE OR PROS [WHILE RUNNING) EXECUTION POINT (IN TRAFFIC CONTROL! 


PROCESS IDENTIFIER TO NOTIFY ON TERMINATION 


CPU TIME USED 


{ WAIT EVENT j 


a WORK CLASS TABLE INDEX P| SPWAKEUPS 


18 TIME OF LAST STATE CHANGE 
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LOCK IDENTIFIER 2 


TRAFFIC CONTROL DATA BASES 


TC DATA 


WAKEUP EVENT FOR ALARM CLOCK MANAGER 
27 


ALARM TIME THREAD 


EVENT CHANNEL TO NOTIFY ON PROCESS TERMINATION 


3 

a. ee eee 
a ee ee 
28 
: 


OEADLINE SCHEDULING TIME 


30 APTE LOCK : 


a ae 


PAGING MEASURE 


ACCESS ISOLATION MECHANISM (AIM) CLASS 
DESCRIPTOR BASE REGISTER VALUE (OBR) 


VIRTUAL CPU TIME 


40 ITT MESSAGES SENT AND NOT READ OUT 


41 


8 FOR RESPONSE TIME METERING 


OO TT Fe 


. 50 SAVED VALUE OF TEMAX 


51 | PROCSREQUIRED [2 


12 WORDS OF PADDING ‘TO 64 WORDS) 


ACTIVE PROCESS TABLE (APT) 


A HARDCORE (te_data) DATA BASE - ONE PER SYSTEM 
CONSISTS OF AN ARRAY OF APTE’S AS ABOVE 


ACTIVE PROCESS TABLE ENTRY |APTE) 


ONE PER ACTIVE PROCESS 
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SERVICES OF TRAFFIC CONTROL 


WAIT LOCKS 


WAIT LOCKS 


DELETE 
EVENT 


| NOTIFY : 
EVENT 


oo 
a 


SERVICES OF TRAFFIC CONTROL 


PROCESSOR MULTI PLEXING 


@® SINCE THE NUMBER OF ACTIVE PROCESSES GENERALLY EXCEEDS THE NUMBER 
OF PROCESSORS (OFTEN 50:1) THE PROCESSORS MUST BE MULTIPLEXED 


® PROCESSOR MULTIPLEXING IS THE PRIMARY RESPONSIBILITY OF THE TRAFFIC 
CONTROLLER 


® THE MULTICS ARCHITECTURE DICTATES THE FOLLOWING AXIOMS: 


f ALL PROCESSORS ARE SYMMETRICAL 


] AN INTERRUPT IS SEEN BY ALL PROCESSORS AND IS SERVICED BY THE 
PROCESSOR THAT CLAIMS IT FIRST 


J NOT ACTUALLY TRUE, DUE TO HARDWARE CONNECTION LIMITATIONS 


] THERE ARE NO MASTER OR SLAVE PROCESSORS. ONLY A PROCESSOR 
DESIGNATED TO PERFORM BOOTLOAD AND SHUTDOWN (THE "BOOTLOAD 
PROCESSOR” ) 


) BOOTLOAD PROCESSOR CAN BE CHANGED AT ANY TIME BY DYNAMIC 
RECONFIGURATION 


1 A PROCESSOR MAY BE "IN" AT MOST ONE PROCESS AT A TIME 


1 A PROCESS MAY EXECUTE ON ONE AND ONLY ONE PROCESSOR AT A TIME. 
THE PROCESS MAY, HOWEVER, "RANDOMLY" MIGRATE FROM ONE PROCESSOR 
TO ANOTHER 
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SERVICES OF TRAFFIC CONTROL 


PROCESSOR MULTI PLEXING 


f A PROCESSOR WILL, AT ALL TIMES, BE "IN" A PROCESS 


PROCESSES MAY EXIST IN ONE OF SIX STATES - ONE OF WHICH IS 


"RUNNING" (IE: EXECUTING ON A PROCESSOR) 


THE TRAFFIC CONTROLLER CODE PERFORMS ALL STATE CHANGES. 


LMPOSED, 


THE STATES 
CHANGES FALL INTO TWO CATEGORIES: SELF IMPOSED AND EXTERNALLY 


) SELF IMPOSED STATE CHANGES (THE PROCESS MUST HAVE A PROCESSOR) 


. RUNNING -> READY (#1 -> #2) 


J THE PROCESS WAS TOLD (BY EITHER A CONNECT FAULT FROM 
ANOTHER PROCESSOR OR A TIMER RUNOUT) TO GIVE UP ITS 


PROCESSOR 


f THE PROCESS IS NOW WAITING FOR NO OTHER RESOURCE THAN A 


PROCESSOR 


f RUNNING -> WAITING (#1 -> #3) 


) THE PROCESS ISSUED A REQUEST FOR A "SYSTEM EVENT" (EG: 


PAGE FAULT OR A WAIT LOCK) 


) “SYSTEM EVENTS" OCCUR AFTER A PREDICTABLY SHORT PERIOD OF 
TIME AND ARE HANDLED BY THE WAIT/NOTIFY MECHANISM 


) THE PROCESS IS NOW WAITING FOR A NOTIFY INDICATING THE 
THE PAGE 


COMPLETION OF THE EVENT (EG: THE ARRIVAL OF 
MAIN MEMORY ) 
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SERVICES OF TRAFFIC CONTROL 


PROCESSOR MULTI PLEXING 


{| RUNNING -> PAGE TABLE LOCK WAITING (#1 -> #6). 


e 


THE PROCESS ATTEMPTED TO LOCK THE PAGE-TABLE LOCK AND 
FOUND IT ALREADY LOCKED 


THE PROCESS IS NOW WAITING FOR A NOTIFY INDICATING THE 
UNLOCKING (A SYSTEM EVENT) 


) RUNNING -> BLOCKED (#1 -> #4) 


THE PROCESS ISSUED A REQUEST FOR A "USER EVENT" (EG: A 
READ FROM THE TERMINAL) 


"USER EVENTS" OCCUR AFTER A PREDICTABLY LONG PERIOD OF 
TIME AND ARE HANDLED BY THE BLOCK/WAKEUP MECHANISM 


THE PROCESS IS NOW WAITING FOR A WAKE_UP INDICATING THE 
COMPLETION OF THE EVENT (EG: A LINE_FEED GENERATES A 
WAKE_UP) ARE HANDLED BY THE BLOCK/WAKE_UP MECHANISM 


A PROCESS GOING BLOCKED GIVES UP ITS RING ZERO STACK 


] RUNNING -> STOPPED (#1 -> 45) 


THE PROCESS EXECUTED THE logout OR new_proc COMMAND, 
EVENTUALLY CALLING hecs_Sstop_process 


THE PROCESS IS PROHIBITED FROM RUNNING AGAIN AND WILL 
QUICKLY BE DESTROYED BY THE INITIALIZER 
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SERVICES OF TRAFFIC CONTROL 


PROCESSOR MULTIPLEXING 


EXTERNALLY IMPOSED STATE CHANGES (THE STATE IS CHANGED BY 
ANOTHER PROCESS) 


Be 


READY -> RUNNING (#2 -> #1) 


l 


THE PROCESS (WHICH WAS WAITING FOR NO OTHER RESOURCE THAN 
A PROCESSOR) WAS CHOSEN AS SUCCESSOR BY A _ PROCESS 
RELINQUISHING A PROCESSOR 


THE PROCESS IS NOW EXECUTING 


BLOCKED -> READY (#4 -> #2) 


| 


SOME OTHER PROCESS SENT A WAKEUP INDICATING THE COMPLETION 
OF THE EVENT THIS PROCESS WAS WAITING ON, AND CHANGE THE 
STATE OF THIS PROCESS 


THE PROCESS IS NOW WAITING FOR NO OTHER RESOURCE THAN A 
PROCESSOR 


WAITING -> READY (#6 -> #2) 


PTL-WAITING -> READY (#3 -> #2) 


l 


SOME OTHER PROCESS SENT A NOTIFY INDICATING THE COMPLETION 
OF THE EVENT THIS PROCESS WAS WAITING ON, AND CHANGED THE 
STATE OF THIS PROCESS 


THE PROCESS IS NOW WAITING FOR NO OTHER RESOURCE THAN A 
PROCESSOR | 
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TRAFFIC CONTROL STATES 
\enFer& i.stop (1.6m) | STOPPED 
Love LOGOUT/NEW-PROC 5 #5 
5 A i (s) or 
2 | \ Sos 
E 
- BLOCKED y 
a 1: #4 © 
E PT LOCK a (b) e 
rT) 
: WAITING } eens : 
¢ 8 
o ' a 
oe : 
, ct 
last ~ (I2 3 get.work (6/s) 


” SCHEDULING 


a a g 
| & = fc Q 
tees 1 f a a a | 
— ee i ae Slice $ y 
\e \asT lone Cin en eer fi me : ae 1 
Sher ler “ne Sire § Cavorn Ble i oe ~«—___—— 2 
WATH SOM Ogeloag For VahFic! Quit Sey Po =a IDLE <— 3 
won Kralire Vong Car nia (VTS VU 4 TOP of wh 
ELIGIBLE PROCESSES (13) INELIGIBLE PROCESSES (87) 
we rege a a are een Aa 


ae Nn ttm aren set SG 
* ALL FIGURES ARE BASED ON METERS FROM A 100 USER, 3 CPU, 2.5M MEMORY, MAXE = 16 SYSTEM. . 
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SERVICES OF TRAFFIC CONTROL 


PROCESSOR MULTI PLEXING 


TRAFFIC CONTROL SCENARIO 


SCENE 1: CPU “C” TAKES AN INTERRUPT 


Jones.ProjA 
Smith.FED 


1. EVENT 3331 OCCURES. 
CPU “C’ TAKES THE 
INTERRUPT AND STORES 
MACHINE CONDITIONS 


2. May.F01 NOTIFIES White.FED - 
Kelly.EREG BY CHANGING 1662 | w | 
HIS STATE TO READY (r) | : f 


WHICH LOOKS FOR AN 

EXECUTING (x) PROCESS 

LOWER THAN Kelly.EREG, 

FINDS IDLE_A, AND , Green.MMPP 
SENDS CPU “A” A CONNECT 

FAULT (cioc INSTRUCTION) 


3. May.F01 CALLS get-processor en ie << rT, 


get-processor 
( MAYBE SUCCESSFUL ) 


4. May.F01 RESUMES PRIOR 
ACTIVITY BY RESTORING 
MACHINE CONDITIONS 
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SERVICES OF TRAFFIC CONTROL 


PROCESSOR MULTIPLEXING 


TRAFFIC CONTROL SCENARIO 


SCENE 2: CPU “A” RECEIVES CONNECT FAULT 


Jones.ProjA 


Smith.FED = 


1043 } w | 


1. CPU “A” RECEIVES CON- 
NECT FAULT AND STORES 
MACHINE CONDITIONS 


2. Idle_A BEGINS PRE- EMPTION 
BY CHANGING STATE TO 
READY (r) 


White. FED : 
1662 


3. Idle_A CALLS get-work 
WHICH LOOKS FOR THE 
HIGHEST READY [ri 
PROCESS, FINDS Kelly.EREG, | | : — . 
CHANGES HIS STATE TO 
EXECUTING (x) AND CPU 
TAG TO “A”, AND LOADS 


get-work 
(IS ALWAYS SUCCESSFUL) 


—_——= fF 
4. Kelly. EREG RESUMES Ei 
PRIOR ACTIVITY BY Perm S 1 
RESTORING MACHINE 
CONDITIONS 
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WORKING SETS AND PAGE THRASHING 


AB A CDA CDB E FCD CDFE FED GF 


A@Ma coB ®©@EF)cD CEFE FED @F | (7PaceEFAULts) 


A ODA cP@OOOr CEFE Pee © F adaceERUIa 


TIME 


WORKING SET = 7 PAGES 


e CASE #-1: THRASHING = 


@ CASE #2: THRASHING = 


ONIXGIdILINN wosszo0dd 
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SERVICES OF TRAFFIC CONTROL 
PROCESSOR MULTIPLEXING 


IDLE CATEGORIES 


ELIGIBLE NOT ELIGIBLE . 
RUNNING | WAITING | READY | READY | READY, BUT 
: IN OVERUSED 
WORKCLASS 


Now arth. Cragin e- 
Some do pie, BYT NMP 
neT PNOVEL Yo heel IDLE 
a\l P recesleoRs Busy 


would have 6¢7 LOADING 
used BY Soneore RTIDLE 
They 0: Ont'T heve 

QOSeQ In MPMOFS 


Moll: Brocsmmmnin 
vsekS elas Ble 
IDLE 
Rol we Qre 
AT MAYBE meaning, MAYE Toto 
YX ether PoAie te 
OY Mnrether nm AD mip 18 Vent ee 
CPu SS Time  , WORKCLASS \Ole 
to Qin Castead IDLE 
gr Giving rl Te Peodcess 
PT MAY % Cor The OOK 
Class 


© Xn QcevS Méx€=% 


K last Process Be Lrg loa l oct 
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TRAFFIC CONTROL METERS 


total time meters 


cond Feem Bonarn 


@ TOTAL_TIME_METERS - OVERVIEW OF HOW THE SYSTEM IS USING [TS 
RESOURCES, ALSO MEASURED AGAINST NON-IDLE TIME 


Total metering time 0:20:36 gate vee! 
: por 12 ~ 
% ZNI _ AVE 
not mk Noes | 
Page Faults 6855 7519" °/21305424 yaa 
PC Loop Locks 0.39 0.43 1993.205 peers oo cer Oe 
PC Queue 0.86 0.94 348.946 5'2rere VES f 
Seg Faults 1.74 1.90 9579.170 Attrating © deachveTiny seas 
kick Bound Faults 0.15 0.16  17426.208 7 ‘ . 
fle “Interrupts 9.02 9.89 1713.504 VeleTed Yo (age Favil ARMTy 
co Nin Ga 2 Other Fault 8.45 9,27- 
ne p,1  § Getwork : 4.54 4,98 660.550 
e asic QTC Loop Locks 0.20 0.22 247.788 
en! (Post Purging 0.36 0.393Q@ 1407.132 
MP Idle 0.70 0.77 Var leet Becase Mex F& ee Re Clow 2% 
Work Class Idle 0.98 1.08 
Loading Idle O<26 ome Ry, 
NMP Idle 8.84) 4 1, 
zero Idle e200y 


-Other Overhead 0803 ee ay ee 
Virtual CPU Time §2.53 68.59 Bile Fo users 
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TRAFFIC CONTROL METERS 


traffic control meters 


@® TRAFFIC CONTROL METERS ~ DISPLAY THE STATE OF THE SCHEDULER 


{ OUTPUT COMES IN THREE PARTS, SHOWN OUT OF ORDER HERE: 


) QUEUE LENGTHS AND RESPONSE TIME - THESE ARE WEIGHTED AVERAGES ~ 
OVER THE LAST FIFTEEN SECONDS. 


J ACTIVITIES VERSUS DEPTH - HOW DEEP THE TRAFFIC CONTROLLER HAD 
TO SEARCH TO FIND A SCHEDULABLE PROCESS 


f MISCELLANEOUS COUNTERS AND FREQUENCIES OF VARIOUS EVENTS 


ont 
Total metering time 0:20:34 ga 
grocs 1S 
Ave queue length 16.52 -4% . on 
Ave eligible £3.37. (WE Ae cet y “Re OE 
Response time 0.264 sec Covde rensete, © | gus VO. de. 
Tree er 
DEPTH %PF TBPF %GTW TBS %CPU nor wee) gee? 
NAwwe 
fi 2260 2268 10.3 12.6 Bad 
2 tess. ke be Louw 7.4 
3 10.8 24. Se 7 14.1 8.0 
4 10.2. 27,8 8.5 Loe 8.4 
5 Ceo, tee Soo 15.5 8.4 
6 8.4 33.5 728 16.9 8.4 
7 7.4 36.3 1463 16.8 3.0 
8 30.0 48.6 3955 16.8: 43,3 


(eSPense_reTer§ Good red on of fo S@onse Time: 
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TRAFFIC CONTROL METERS 


traffic control meters 


COUNTER 


Interactions 
Loadings 
Blocks 
Wakeups 
Schedulings 
Lost priority 
Priority boosts 
I/O boosts 
Wait Page 
Wait PTL 
Wait Other 
Total Waits 
Notify Page 
Notify PTL 
Notify Other 
Total Notifies 
Get Processor 
Pre-empts 
Getwork 
Retry getwork 
Extra notifies 
Last EN event 
Last NTO event 


ALARM CLOCK_METERS - 
TIMER FACILITY (HARDCORE INTERFACE FOR timer_manager_) 


Total metering time 


No. 
Simulation lag 


- Max. lag 
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TOTAL -ATB 
7977 Getao 
i2161 0.102 
14082 0.088 
36078 0.034 
i253) 0.098 
1 1234.756 
e) 0.000 
578 2.136 
127040 9.713 
735691 165313 
31912 38.693 
234643 De262 
128954 eee eo) 
15091 abso 13 
25530 48.747 
229915 32369 
245856 5.022 
94235 136103 
338802 3.644 
4988 0.248 
2949 0.419 
o00000000071 
033022237767 
DISPLAYS 


sec 
sec 
sec 
sec 
sec 
sec 
sec 
sec 
msec 
msec 
msec 
msec 
msec 
msec 
msec 
msec 
msec 
mSeéc 
mSec 
sec 
sec 


x /INT 


Ls5Z5 


12576 


Po3926 


9.489 
4.001 
29.615 


18235 


INFORMATION ABOUT THE 


2171 


0220334 


5.245 msecs. 
1.7340314e4 msecs. 
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a onto! = \ wea 
THAER?S : TRAFFIC CONTROL METERS hak \nn id CoV = 
O4bo. am y Sor? 
anne ax sim traffic control queue 
Qrocr S06 et ees 
FNHe Stor 
@ TRAFFIC_CONTROL_QUEUE - DISPLAYS THE CURRENT CONTENTS OF THE 
SCHEDULER QUEUES, USEFUL FOR GETTING AN ICEA OF WHAT THE USER yor 
’ PROCESSES ARE DOING was A) 
Tone doy Re 6 NA 
\ } 
A vy ne? 
pO T FIRST PART OF opTPUT 1S {ELIGIBLE QUEUE: + ese 
AT SS <9 : 
. es Nake a) 2 i N kos a ae ogi r &- 
cathe sve a wore ee CDS 
avg = 13,\elapsed time = 1247 ae Wer 
flags dtu dpf temax te process re eee 
\d-rWLE (d) 148 6946 2097 37 “ -0. 6 O initializer ~7'@ waren 
assy XLED(c) 15 11 1000 910 2012 aes 0. 11 6 Sibert wer 
ey rLe (d) 14 4©613760=—«5500s=89 fs) Oo -0. Oo & Diaz 
LE (d) 15 823 506 13 9 Oo -0. 64 8 JCrow 
My RRM WE (2) 13 634 500 422 0 6° 0. 3 3 Gintel! 
xWLED (a) 6 1608 1000 495 205: 2004 06.6 13. 6 Brunelle 
a LE (dj 16 86, 1000 85 0 £19 0. 46 6 Wreck 
ear wWi—(b) b68 2736 1000 315 3010 gooo 4. , 3 Spratt 
wr WE 17 «686 «= 00 60 ) Oo 68. 3 & RTowle 
ie Wi ( ie 520 500 50 G oO. Ox 3 2 Kress 
WLE (d) $5 1885 509 21 0 0 «(O. o. -2 OPCTE 
eee 2 572 596 &5 6 9 Cy 6 3 Pandolf 
67 3272 509 fe 0 0 -9. GC 3 Lackey 
vk a, | ; . - . 
Asie avy Yn Cs 


a 


QveAl 9 
: Yecoce > AST \ock cer clog 
Lye ae ni venks addess aria 
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traffic control aueuvue 


f SECOND PART IS REALTIME, INTERACTIVE, AND ALL WORKCLASS QUEUES: 


REALTIME QUEUE: 


INTERACTIVE QUEUE: 


WORKCLASS 2 QUEUE: 


WORKCLASS 3 QUEUE: 


rc 252 SoZ 
= d32 vibes 


WORKCLASS 4 QUEUE: 


WORKCLASS 5 QUEUE 


WORKCLASS 6 QUEUE 
WORKCLASS 7 QUEUE 
rk > i6 


CJ) ee 


WORKCLASS if QUEUE: 


WORKCLASS 11 QUEUE: 
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credits 
credits 


1000 
1000 


ronnie 
Srecucs 


= 576 ms. 


= 242 ms. 
0 0 503 C2218 
0 40130 8000 0.226 
= 2601 ms. 
= 4000 ms. 


= -56€3 ms. 
= 3962 ms. 

0 0 0 6.192 
= 2538 ms. 


= 22:6 ms. 


= 4000 ms. 


= £000 ms. 


Dosd ‘TA Qive OUT 
Setlecy ON casi Ta 


work Clas Go 4 


922 


Oo 
Oo 
e 


6 (0 2 4. Saseuer 


H Pr 
TRAFFIC CONTROL METERS feses Ay sh a Chango 


work class meters 


@ WORK_CLASS METERS - DISPLAY THE VARIOUS WORKCLASS PARAMETERS, AND 
SHOW WHAT RESOURCES EACH WORKCLASS !S CONSUMING. 


tive 
eet 


0:20:38 on WES ne 


pS 
| LCG \ oad ciel OS Ee 


Total metering\t! 


WC %GUAR %MAX &TCP V/ELIG PW IRESP I QUANT RESP QUANT FP MR 
0 3. 0.12 3 0.26 2.10 0.26 2.10 POR I Init 
1 3. 0.09 1 0.25 0.75 0.50 1.00 P OR! RTime . 
2 Ts 15. 0.44 1 P 0 | System SysAdm OPR FED 
3 325 bk. 0.49 1 PO i SysProg SysDev 
L Oo. 1h. L. 0.26 1 PO Stngr 
5 20. Ze 0.46 1 P 0 | HEngr 
6 124 Te 8. 0.25 1 P 0 MktUS MktFor MktEd 
7 3. Va L. 0.36 1 P 0 DS=cC 
8 6. oO. 0.18 1 PO | Of fAute 
5 L. 8. 2 0.62 !} PO Mise Mfg 
10 ce 2D. 0.55 1 P O | Other 
ii bs z. 0.16 1 "PG 1 Special 


TCPU percents (%GUAR) control non-realtime work _ciasses. 
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Jp Weak Ee Contra 900 - = ioe 
+0 *S “Je OK. jF Vou beave Shoe] Vy oe 


From 9 

oul d nor mally Push ve 
bine Fal tS Rut na y 
TRAFFIC CONTROL METERS 7 Z1gy oF " hot t 

tae Srgtr Jogs Sy 

respons meters rm? T aa tA Bye Vong Or, Shorts doRS 

Se Or hy {on Thr sugh Qu. ket 
@ RESPONSE METERS - BISPLAYS RESPONSE TIME, BASED ON TERMINAL 


INTERACTIONS, ON A PER-WORKCLASS BASIS 
Wee PO~Se Seen (SF vsebd f 
; Qh ake swe we 


¥ 


; Tre 
: . . “ 7 \eavir’) yun 
otal metering time 0:20:36 Tin ve sta) 


---Tninks/-- Be ORR by VCPU Range---- Load Contreci Group 


We 
-~--Queues--- -~VCPU Range- # Avg Avg Resp 
Pay, # Ave From To Int VCPU RT Fact coason Ae |e. 
veh Maer gro '° 14 
} ; Yar) Ges : varie > v 
pv’ 0 Bo 2270 0.00 6.50 113 OvOk “Osu2 9.38 init 
Pen ( 92 0.15 0.50 1.00 3 0.55 5.51 10.00 
he’ oe 1.00 16.00 3 2.43 16.96 6.15 
rate ee eens 119 0.12 0.91 7.76 
ar 
} Some eae 0.06 0,56 34 O.11 6.96 §.74 RTime 
RO) 0275 6.59 1.00 2 0.83 4.06 4.87 
amie eae 36 0.15 1.13 7.55 
2 £93 14.90 C.00 0.50 620 ©.95 0.45 10.50 System Syskar OFF FED 
612 6.35 0.50 1.00 OP 30271 3561) 50 
1.00 16.60 39 1.77 8.35 4.74 
Secs eeate 687 GMT 4207 wee ot fog = 0% 
7 ™~ 
3 2695 4.3 0.00 0.50 2093 0 
3622-0 17 we 050 1.06 Li. % 
1.00 10.00 a 2 
\t0.09 99.99 10 55 
peers Seae= 3186 0 
L S81 15.82 C.05 0.50 663 0.05 0.71 12.94 SEngr 
550. Or 26 0.50 1.09 13? O.6e ste 736 
1.06 10.00 S 3ub 7 3207) <On2t 
Seer) (SeSte 68, 0.11 1.15 10.88 
5 133 29.51 0.00 0.50 148 0.06 0©.83 12.95 HEngr 
| pel. (Og 0.50 1.00 3: 069 -bebk.- 6.70 
¢ \ . 
BIO To Lest Fee Wiens 1.00 10.00 5 3.15 10.24 
Be Oe a oe Oe 
= 10.00 99.99 2 26.69 48.84 
1) look A: O00 Bear oi ceo 158 0.51 1.81 


Te £ esr 38 y HO Grohably oie | wt han) nd Poasy , 
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TRAFFIC CONTROL METERS 


respons meters 


1180 11.65 0.00 0.50 977 0.05 1.13 20.91 MktUS MktFor MktEd 
1211 0.58 0.50 1.00 2h 0.64 &.95 7.7h 
1.00 10.06 16 1.89 11.88 6.29 
corer cecee 1017 0.10 1.39 14.38 
259 14.65 0.00 0.50 292 0.08 1.53 20.17 DBS-CC 
287 0.98 0.50 1.00 9 0.71 9.93 12.66. 
1.00 10.00 17 2.04 14.76 7.2kh 
10.00 99.99 112.22 99.99 9.45 
S-SSS SSS = 319 O.2h 2.81 11.86 
73 «2.69 0.00 0.50 79 0.06 O.31 5.45 OffAuto 
7&4 0.05 C.50 1.00 2 0.60 6.40 10.62 
1.00 10.00 1 3.20 6./3 2.10 
SSS S552 82 0.11 0.54 4&.9h 
Su 41.91 0.cO ¢.50 8O 0.11 1.23 11.9 Mise Mfg 
96 0.30 0.50 1.00 11 0.69 k&.7b 6.91 
1.00 10.06 13. 2.95 12.62 &.30 
a la 104° °0,.53 3005 -§.74 
7 99.99 0.00 50 10 0.11 1.45 13.82 Other 
8 0.21 1.€9 16.00 i 3.88 39.11 10.09 
SSS: sess 11 0.45 4.68 16.89 
Bly Bend 0.0G 0.50 b45 0.03 0.50 15.32 Special 
L206 0.15 &.5C i.30 5 Ons) 3261 -ba2 
1.90 106.00 4h 1.65 li.b &.90 
ceer- cece £54 ©.95 0.63 11.92 
595i 11.1% 0.00 0.59 64654 0.07 C.77 11.20 
6192 6.29 0.50 2.00 217 O.68 &.5hk 6.7 
reQ0: 70.60 173? 2533. Een 5.62 
10.06 99.99 13.48.77 98.95 2.32 
oat ial cela 6557 0.24 1.51 6.39 
86797 calls to meter_response_time 283 invalid transitions. 
Overhead = 0.09% ( 0.052 ms./cal)) 


Cc 
(a) 
o 
Q) 
\o 
i) 
tw 
ay 
rT 
oo 
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post purce meters Aluays Q 


&® POST_PURGE_METERS - DISPLAY THE STATE OF POST-PURGE ACTIVITY. 


f CONSIDERABLY MORE DETAILED METERS ARE KEPT BY RING ZERO, BUT NOT 
REPORTED AND NOT PARTICULARLY INTERESTING. 


Total metering time 0:20:29 

Post purge time 1.41 msec. (0.36% of system) 
Ave list size 17.76 entries 

Ave working set 5.59 pages 

Working set factor 0.50 

Working set addenda 0 

Threshing percentage 1.34 % 

Ave post in core 10.65 _ (59.94 %) 
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print tuning parameters i\SO CG 


8 PRINT TUNING PARAMETERS = PRINT VALUES FOR SYSTEM CONTROL 
PARAMETERS. MOST CONTROL THE SCHEDULER 


Current system tuning parameters: 


tefirst 0.5 seconds 
° telast 1. seconds 
timax 8. seconds 
priority _sched_inc 80. seconds 
min_eligible 26 
max_eligible 20. : in, Hels 
max batch_elig O Ay Jobs getive aY Tims 
working _set_factor 0.5 
working set_addend 0 Makos an wes Fal Tere 
deadline mode Of Ebonch rrr ° Ky VR 
int q enabled On Slsta\ > vorT Loon Te glately CE YO reanetvg 
post_purge On AePAAT VF oFm s Umless os 
ms ~o<pre_empt sample time .04 seconds 
how OFTPT a Pre ose wel atenpy To pee ae es Reeiey = eee Ge Deas le 
gp_at ptlnotify L OEE) Tete Oe 
process initial quantum 2. seconds ve ot loaied w fat 
hormef/ = 45 = / quit_priority QO. ing peo ania 
ie oie fe pee ie of fg i eegrat comin he seconds i iiss For egcoren 
avi feionty <7 Rw aeT cheng anfthng | - Fealtimelio_priority)mted on oe defaut Orn 
os realtime_io_deadiine my ie 0. seconds 


realtime_io_quantum 0.005 seconds 


nati Py onaa prey se acn - notify _timeout_interval 30. seconds 
Soiled, y? eV Bic Tham anys notify timeout severity — 0-7 friny o const, log, alarm 
bad write limit 724 


Syserr codes ttl. FL | 


) THESE ARE "INTERNAL", NORMALLY NEVER CHANGED, AND ONLY PRINTED 
IF THE -all CONTROL ARGUMENT IS GIVEN 


stack truncation on 
stack _truncation_always off 
stk_trunc_block_avg_ factor 0.25 
trap_invalid_masked off 
meter_ast_locking Off 
checksum_filemap on 
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print apt entry 


TRAFFIC CONTROL COMMANDS 


ds Plep— 


Dad 


PRINT_APT_ENTRY - INTERPRETS AND DUMPS AN APT ENTRY 


ectePhh ier 


! print_apt_entry Sibert -dump 


CeTlen Vhaw cule 


Sibert.Multics.a b.h126 at 10300 in tc_data, >pdd>!Bb1CpbBDBBBBBB 
PID:010300356001 TRM:000447007410 407777000460 
Running for 0,06/7825..¢since 01326253).. 

Usage: cpu 8:40.8; vepu 6:04.6; pf 23622. 


te/s/i/x: 


0.411 0.000 0.647 32.000. 


Flags: loaded,eligible,mbzii,dbr_ loaded. 
Alarm in 31.244 (at 01:29:24). 


005400003000 
000001443141 
000000000000 
003000777777 
000000000000 
000000000000 
000447007410 
000000111567 
000000000000 
035117540004 
000000000000 
000000111567 
000000000000 
000000000000 
000000000000 
000000000000 
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014225000001 
000000000000 
000000000000 
115641364232 
001360000002 
000000000000 
407777000460 
437736532472 
000004325430 
001775100023 
000000000000 
457572506651 
002557051053 
000000000000 
000000000000 
000000000000 


o> 26 


000000056106 
000002356631 
005200013740 
000000000000 
000000111567 
O1T7001L11567 
000000000000 
003322000000 
000000000000 
000000000000 
000000000004 
000000000000 
000001720440 
000000000000 
000000000000 
000000000000 


(End Of Topic) 


010300356001 
000172044000 
000000002076 
003702747134 
457572337662 
457761705103 
000001720440 
000000000000 
000000000000 
002556711030 
000000004441 
014274070015 
776000000000 
000000000000 
000000000000 
000000000000 
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TOPIC 2 


‘Fault and Interrupt Handling 


Fault and Interrupt Handling Overview. 
Fault and Interrupt Data Bases . 
Fault and Interrupt Vectors. 
Fault Data Save Areas. ... 
Important Types of Faults. . 
Fault/Interrupt Meters ..... 
fim_meters . . 2. 2. 2 « © © - 
interrupt_meters ...... 
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FAULT AND INTERRUPT HANDLING OVERVIEW 


_@ FUNCTION 


J RESPONSIBLE FOR HANDLING ALL EXCEPTIONS IN A CPU WHETHER 
INTERNAL TO THE PROCESSOR (REFERRED TO AS FAULTS) OR EXTERNAL 
(REFERRED TO AS INTERRUPTS ) 


) ESTABLISHES THE SUPERVISOR ENVIRONMENT AT FAULT AND INTERRUPT 
TIME. SAVES THE MACHINE CONDITIONS AND TRANSFERS TO THE 
APPROPRIATE HANDLER 


) MAJOR COMPONENTS: THE FAULT INTERCEPT MODULE (fim), WIRED-FAULT 
INTERCEPT MODULE (wired fim), 170 INTERRUPT HANDLER 
(lo_interrupt), sys_trouble, page fault 


_— 


— Etote Conte ont 


® MAJOR DATA BASES 


J INTERRUPT VECTORS - ONE SET PER SYSTEM (WIRED) 


] INTERRUPT PAIR (2 INSTRUCTIONS) - ONE PAIR PER DEFINED 
INTERRUPT TYPE 


LOCATED AT ABSOLUTE ADDRESS 0. A HARDWARE RECOGNIZED DATA 
BASE 


] DESCRIBE WHERE TO SAVE THE CONTEXT, AND WHERE TO TRANSFER TO 
TO PROCESS THE INTERRUPT (ALWAYS io_interrupt) 
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FAULT AND INTERRUPT HANDLING OVERVIEW 


. FAULT VECTORS - ONE SET PER SYSTEM (WIRED) 


f VECTOR PAIR (2 INSTRUCTIONS) - ONE PAIR PER DEFINED FAULT 
TYPE 


| LOCATED AT ABSOLUTE ADDRESS 100 (OCTAL) IMMEDIATELY ABOVE THE 
INTERRUPT VECTORS. A HARDWARE RECOGNIZED DATA BASE 


J DESCRIBE WHERE TO ‘SAVE THE CONTEXT, AND WHERE TO TRANSFER TO 
TO PROCESS THE FAULT (fim, wired_fim, page fault) 


J PROCESS DATA SEGMENT (PDS) - ONE PER PROCESS (WIRED WHEN 
ELIGIBLE) 


J CONTAINS PROCESS RELEVANT INFO SUCH AS PROCESS ID, USER ID, 
HOME /WORKING/PROCESS DIRECTORIES, AIM CLASSIFICATION, INITIAL 
RING, ETC 


f CONTAINS ALL INFORMATION ABOUT THE PROCESS NEEDED BY THE 
SUPERVISOR CODE WHEN THE PROCESS IS RUNNING 


. CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH CAN RESULT IN GIVING UP THE PROCESSOR: PAGE FAULTS, 
SEGMENT FAULTS, AND ALL FAULTS NOT HANDLED BY THE SUPERVISOR 


[ PROCESSOR DATA SEGMENT (PRDS) - ONE PER CONFIGURED CPU (WIRED) 


et 


Jf SERVES AS RING-ZERO STACK FOR PAGE CONTROL AND TRAFFIC 
CONTROL 


) ALSO CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH USUALLY DO NOT MEAN GIVING UP THE PROCESSOR: CONNECT 
FAULTS AND INTERRUPTS. 
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FAULT AND INTERRUPT HANDLING OVERVIEW 


| FIM_TABLE 


f A TABLE IN THE FIM PROGRAM WHICH DESCRIBES THE ACTION TO BE 
TAKEN FOR VARIOUS TYPES OF FAULTS 
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FAULT AND INTERRUPT VECTORS 


® ALL FAULTS AND INTERRUPTS ARE HANDLED IN A CENTRALIZED FASHION 


J. FOR EACH FAULT OR INTERRUPT, THERE ARE TWO INSTRUCTIONS: 


. AN scu INSTRUCTION, TO STORE THE ABSOLUTELY ESSENTIAL DATA 
NEEDED TO RESTART FROM THE FAULT 


J A tra INSTRUCTION, TO TRANSFER TO TO THE APPROPRIATE FAULT 
HANDLER 


J ASSOCIATED WITH EACH OF THESE INSTRUCTIONS, THERE IS A POINTER 


f AN SCU DATA POINTER, POINTING TO ONE OF SIX REGIONS WHERE 
FAULT DATA GOES 


f A&A FAULT HANDLER POINTER, INDICATING ONE OF THE PROCEDURES 
USED TO HANDLE FAULTS 


J THESE INSTRUCTIONS AND POINTERS ARE STORED IN THE fault_vector 


f THE DATA STORED BY scu IS ONLY THE "CONTROL UNIT DATA" - EACH 
HANDLER MUST IMMEDIATELY SAVE THE PROGRAM VISIBLE REGISTERS, THE 
EIS POINTER LENGTH DATA, AND SO FORTH. THIS DATA IS ALWAYS 
STORED IN THE SAME FORMAT, THE MACHINE CONDITIONS STRUCTURE 

(me .inel<pld) 
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FAULT AND. INTERRUPT VECTORS 


2222 2 
123 4 


TVW Wea tee 22 2 3 3 3 3 3 3 
6 i123 485 67 89 0912345 6 7 8 $ O 7s: 9012 3 @ § 


2 2 
s 6 


0 08 SCU INDIRECT FOR INTERRUPT TYPE 0 


1 1 TRA INDIRECT FOR INTERRUPT TYPE 0 2 


76 «62 SCU INDIRECT FOR INTERRUPT TYPE 31 


7 8 TRA INDIRECT FOR INTERRUPT TYPE 31 }— 
od SCU INDIREDT FOR FAULT TYPE 0 eee 
TRA INDIRECT FOR FAULT TYPE 0 P| 

ess 


176 126 SCU INDIRECT FOR FAULT TYPE 31 
WW? 127 TRA INDIRECT FOR FAULT TYPE 31 a, 


2 
8 


PTR TO INTERCEPTOR FOR INTERRUPT TYPE 0 


374 282 
PTR TO STORE AREA FOR INTERRUPT TYPE 31 
7S 253 
378 254 
PTR TO INTERCEPTOR FOR INTERRUPT TYPE 31 
377 255 
400 256 
PTR TO STORE AREA FOR FAULT TYPE 0 
401 257 
402 258 
PTR TO INTERCEPTOR FOR FAULT TYPE 0 
403 259 


PTR TO STORE AREA FOR FAULT TYPE 31 


PTR TO (NTERTEPTOR FOR FAULT TYPE 31 


(WORDS) (fault_ vector.anci.pit) 


FAULT AND INTERRUPT VECTORS 


& HARDWARE RECOGNIZED DATA BASE LOCATED 
AT ABSOLUTE ADDRESS 0-577 
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FAULT DATA SAVE AREAS 


THERE ARE SIX REGIONS WHERE MACHINE CONDITIONS ARE STORED. 


THEY ARE SELECTED TO MINIMIZE THE NUMBER OF TIMES WHEN FAULT 
DATA MUST BE MOVED. USUALLY, ONCE FAULT DATA HAS BEEN STORED IN 
A PARTICULAR PLACE, IT CAN BE RESTORED DIRECTLY FROM THERE, BUT 
SOMETIMES IT MUST BE MOVED TO ANOTHER PLACE 


J prdsSinterrupt_data - USED FOR INTERRUPTS, ONLY 


) prdssfim_data - USED FOR FAULTS SUCH AS CONNECT FAULTS, WHICH 
WILL BE HANDLED ENTIRELY USING THE WIRED RING ZERO STACK 
(PRDS ) 


) prdsssys_ trouble data - USED FOR THE FAULT THAT CRASHED vue 
SYSTEM. NO MACHINE CONDITIONS ARE EVER STORED HERE DIRECT 
ONLY MOVED HERE. 


j saeston.- data - USED FOR FAULTS WHICH WILL BE HANDLED IN RING 
' ZERO, USING THE RING ZERO STACK, WHERE PAGE FAULTS MIGHT BE 
TAKEN WHILE THE OTHER FAULT IS BEING HANDLED 


l pdsspage_fault_data - USED FOR PAGE FAULTS AND TIMER RUNOUTS 
S iges INDICATE THE END OF A QUANTUM) - BOTH ARE EVENTS WHICH 
ALMOST ALWAYS RESULT IN GIVING UP THE PROCESSOR, BUT WHICH 

ARE HANDLED ON THE WIRED RING ZERO STACK (PRDS) 


[ pdsssignal_data - USED FOR FAULTS.WHICH WILL BE SIGNALLED OUT 
FOR THE USER RING TO HANDLE. IF AN ERROR OCCURS PROCESSING 
SOME FAULT IN RING ZERO, ITS FAULT DATA IS MOVED HERE BEFORE 
SIGNALLING 


THERE ARE ALSO SPECIAL STACK FRAMES CREATED BY THE FIM USED FOR 
FAULT SIGNALLING, AND THE MACHINE CONDITIONS ARE COPIED THERE. 
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IMPORTANT TYPES OF FAULTS 


@ CERTAIN FAULTS DESERVE SPECIAL DISCUSSION, AS THEY ARE USED TO 
IMPLEMENT IMPORTANT SUPERVISOR SERVICES 


" ) LINKAGE FAULT 


f OCCUR WHEN A POINTER CONTAINING 46 OCTAL IN THE LOW SIX BITS 
OF THE FIRST WORD IS USED 


f USED TO IMPLEMENT DYNAMIC LINKING {SEE NAME/ADDRESS SPACE 
MANAGEMENT, TOPIC 4) 


J USES pdssfim_data, IS HANDLED BY fim.alm, WHICH INVOKES 
link_man.pli, HANDLED ENTIRELY ON THE stack_0 


[ SEGMENT FAULT 


f OCCURS WHEN AN NON-ACTIVE SEGMENT IS REFERENCED (SEE SEGMENT 
CONTROL, TOPIC 7) 


1 USES pdssfim data, IS HANDLED BY fim.alm, WHICH INVOKES 
seg fault.pl1, HANDLED ENTIRELY ON THE stack_0 | 


J A SEGMENT FAULT MAY OCCUR WHILE ANOTHER IS BEING HANDLED, AND 
IT WILL BE HANDLED RECURSIVELY 


| PAGE FAULT 


1 OCCURS WHEN A PAGE NOT IN MEMORY IS REFERENCED (SEE PAGE 
CONTROL, TOPIC 8) 
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IMPORTANT TYPES OF FAULTS 


f USES pdssSpage fault data, Is HANDLED DIRECTLY BY 
page _fault.alm, AND IS “HANDLED ENTIRELY ON THE PRDS. 


vy nin. Syed 
| TIMER RUNOUT Qian d wos WHO WEF TD Aare & 


J OCCURS WHEN THE TIMER REGISTER IS DECREMENTED THROUGH ZERO, 
INDICATING THAT THE RUNNING PROCESS HAS NOW OVERSTAYED ITS 
WELCOME, AND SHOULD LOSE ELIGIBILITY 


f TIMER RUNOUT FAULTS ARE ALSO USED INTERNAL TO TRAFFIC 
CONTROL TO IMPLEMENT "PRE-EMPT" SAMPLING; IN THIS MODE, 
NOW THE DEFAULT, THE TIMER GOES OFF EVERY FEW MILLISECONDS 
AND THE PROCESS CHECKS TO SEE WHETHER A HIGHER PRIORITY 
PROCESS WANTS THE PROCESSOR; THIS DOES NOT MAKE THE 

-RUNNING PROCESS INELIGIBLE, HOWEVER, UNLESS ITS QUANTUM 
HAS ALSO RUN OUT 


J A PROCESS RUNNING IN RING ZERO NEED NEVER GIVE UP 
ELIGIBILITY - WHEN A TIMER RUNOUT HAPPENS, IT REMEMBERS, 
AND SETS THE RING ALARM REGISTER, WHICH WILL CAUSE A RING 


ALARM FAULT LATER ON WHEN IT LEAVES RING ZERO 
“Then makes Un ine ay ble 


= 


USES pdsspage fault_data, IS HANDLED DIRECTLY BY pxss.alm, 
AND IS HANDLED ENTIRELY ON THE PRDS. 


f RING ALARM FAULT 


J OCCURS WHEN A PROCESS RETURNS TO AN OUTER RING FROM AN INNER 
RING, AND THE RING ALARM REGISTER HAS BEEN SET 


1 (1) USED TO DEFER ACTION ON TIMER RUNOUTS AND CONNECT FAULTS 
(SEE BELOW) UNTIL A PROCESS LEAVES RING ZERO 


) (2) USED TO ENSURE THAT THE SOFTWARE VALIDATION LEVEL (SET 
WITH cu_Slevel_set) IS NEVER LOWER THAN THE RING OF EXECUTION 
- SETTING THE VALIDATION LEVEL ALSO SETS THE RING ALARM 
REGISTER, AND THE RING ALARM FAULT CAUSES THE VALIDATION 
LEVEL TO BE RESET 
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FAULT AND INTERRUPT DATA BASES 


IMPORTANT TYPES OF FAULTS 


| USES pdsspage_fault data, IS HANDLED DIRECTLY BY 
ring_alarm.alm AND IS HANDLED ENTIRELY ON THE PRDS. 


f IS ACTUALLY A SUBTYPE OF ACCESS VIOLATION 


Ugh ¥ NO cleev 

Come vn Cal Or alae en c PU SY 

J CONNECT FAULT | ; % S ave Char ot, 
Aolf whin Ww. i, 


f OCCURS WHEN ONE PROCESSOR SENDS A “connect” TO ANOTHER, USING 
A cioc INSTRUCTION 


J RESEMBLES A SOFTWARE SENDABLE INTERRUPT; ALTHOUGH 
PROCESSORS CAN SEND INTERRUPTS TO EACH OTHER, LIMITATIONS 
OF THE HARDWARE MAKE CONNECT FAULTS EASIER TO USE 


J USED FOR ALL INTERPROCESSOR SIGNALLING - 


HE OR ASSOCIATIVE MEMORY 
] (2) TO PRE- EMPT A PROCESS RUNNING ON ANOTHER CPU (WHEN 
PRE-EMPT SAMPLING IS NOT IN USE) 


f (3) TO INFORM ANOTHER PROCESSOR THAT THE SYSTEM IS 
CRASHING 


1 (4) TO INFORM ANOTHER PROCESSOR THAT IT IS BEING REMOVED 
FROM THE CONFIGURATION 


) USES prdssfim_data, IS SOMETIMES HANDLED BY wired_fim.alm, 
AND IS HANDLED ENTIRELY ON THE PRDS. 


J FOR TYPE 1 CONNECTS (CACHE CLEAR), THE FAULT IS HANDLED 
VERY SPECIALLY BY CODE WHICH IS ACTUALLY EXECUTED FROM 
WITHIN THE PRDS (SEE fast_connect_init.alm), AND RUNS 
SOMEWHAT FASTER. THE COMPLICATED “CASES ARE LEFT TO 
WIRED FIM . 

~ 5 Tem COMMUN cao ra Se Oy mlr'T fo C PU Co Py mUnie O Pron 

\ 194 Conard Fal T 

) CELLS -IN THE scs. ARE USED TO DISTINGUISH BETWEEN THE 
DIFFERENT TYPES OF CONNECT FAULTS; A PROCESSOR SETS THE 
APPROPRIATE CELLS BEFORE SENDING THE CONNECT. 
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FAULT AND INTERRUPT DATA BASES 


—____—e Ee  ) 3 EE eee 


IMPORTANT TYPES OF FAULTS 


| OTHER FAULTS 


J PARITY - RUN AUTOMATIC PARITY ERROR LOGGING AND DIAGNOSIS (TO 
CHIP LEVEL, FOR CACHE) ROUTINES 


. OP_NOT_COMPLETE, COMMAND, SHUTDOWN, STARTUP, STORE, TROUBLE - 
RUN HARDWARE ERROR LOGGING ROUTINES 


J OVERFLOW, UNDERFLOW - CAN BE SET UP TO AUTOMATICALLY SET A 
SPECIFIED (VERY LARGE OR VERY SMALL) VALUE AND RESTART 
WITHOUT INTERRUPTING THE RUNNING PROGRAM 


. DERAIL - USED WHEN CRASHING THE SYSTEM OR VOLUNTARILY 
RETURNING TO BOS TO BEGIN EXECUTION IN BOS. AN ORDINARY 
SIGNALLABLE FAULT AT ALL OTHER TIMES (AND USED THAT WAY BY 
THE gtss EMULATOR). ote Systems “uted Johar Subrrviser Ao SomeT hry. 
\e, beme MEL Cane 


) EXECUTE - USED TO FORCE A SYSTEM CRASH 


VIOLATION - CAN AUTOMATICALLY LOG ACCESS VIOLATIONS 
RITY AUDITS 4 


) OTHERS - HANDLED BY fim.ailm, WHICH MAPS THE HARDWARE FAULTS 
ONTO THE MULTICS ENVIRONMENT CONDITION NAMES 


f CONSIDERABLE INTERPRETATION IS SOMETIMES REQUIRED; FOR 
INSTANCE, A NULL POINTER IS ACTUALLY SIGNALLED BY THE 


HARDWARE AS AN ACCESS VIOLATION, OUT OF BOUNDS ON DSEG, 
FAULT 


| INTERRUPT 


J INTERRUPTS ARE USED TO ANNOUNCE THE COMPLETION OF ALL 1/0 
OPERATIONS, AND ALSO (RARELY ) USED DURING DYNAMIC 
RECONFIGURATION TO START PROCESSORS | 
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FAULT AND INTERRUPT DATA BASES 


IMPORTANT TYPES OF FAULTS 


} USES prdsSinterrupt_data, Is HANDLED DIRECTLY BY 
iom_interrupt.alm OR init_processor.alm, AND IS HANDLED 
ENTIRELY ON THE PRDS. 
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FAULT/INTERRUPT METERS 


fim meters 


® FIM METERS - COUNTS FOR ALL FAULT PROCESSING 


Total metering time: 
fault type 


shutdown 

Store 

mme 1 

fault_tag_i 
timer_runout 
command 

derail 

lockup 

connect 

parity 
illegal_procedure 
op _not_complete 
startup 

overilow 
divide_check 
execute 

segment fault 
page fault 
directed fault _2 
directed. taults 
access violation 
mme 2 

mme 3 

mme 4 

linkage fault 
fault tag. 3 
trouble 


USS Connect 


fp ce > 
: wet y-*? 
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@ INTERRUPT_METERS - COUNTS & TIMING FOR ALL 1/0 INTERRUPTS 


FAULT/INTERRUPT METERS 


interrupt meters 


Total metering time 


IOM Ch Int 
A 6. 41. 
A i0. 379 
A 13. 9253 
A 14, 19 
A 16. 26248 
A 17 128 
A 18 13097 
A 20% 21041 
A 21. 2881 
& -~22% 8486 
A 23 257 
A 24 17896 
A 25 2573 
A 26. 10486 
A 27 255 
a 28 24717 
A 29 2319 
A 30. 9915 
A 31. 215 
B 14, 236 
B 15. 6917 
B 18. 3547 
B 19. 13667 
B 20. 22013 
B 21. 4745 
Br. -<22% 6054 
B 23. 60 
B 24, 15946 
B 25. $89 
B 26. 412757 
B 27. 1020 
B 28. 5178 
B 29. 30 
B 30. 16582 
B 31 825 
B 32 1764 
Chan 262506 
Ovhd 258932 


Total 258932 
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0:20:28 


Avg Time % CPU 


2.043 
1.333 
3.436 
0.788 
1.347 
1.328 
Ies53 
0.860 
0.860 
0.877 
0.964 
0.895 
0.943 
0.857 
0.899 
0.845 
0.849 
0.845 
0. 767 
0.877 
Sudod 
3.2043 
3.435 
0.881 
0.863 
0.661 
0.925 
0.867 
0.841 
0.863 
0.903 
0.838 
0.653 
0.823 
0.841 
06629 


1,464 . 


0.230 
iefis 


(End Of Topic) 
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System Initialization/Shutdown 


TOPIC XI 


System Initialization Overview . 
System Initialization Terminology. . 
Initialization Data Bases. 


Environment Passed 
Collection: © -s «a x 
Collection 1. « «#3 
Collection 2... . 
Collection 3s .4- 30 
Normal Shutdown. .. 
File System Shutdown 
Emergency Shutdown 
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SYSTEM INITIALIZATION OVERVIEW 


® FUNCTION 


PREPARE THE SYSTEM TO OPERATE, STARTING FROM A COMPLETELY EMPTY 
MACHINE 


) READS IN SUPERVISOR PROGRAMS FROM SYSTEM TAPE, SNAPS LINKS 
BETWEEN SUPERVISOR COMPONENTS, VERIFIES AND INITIALIZES HARDWARE 
CONFIGURATION, SETS UP SYSTEM DATABASES, ACCEPTS STORAGE SYSTEM 
DISKS AND PREPARES THEM FOR USE BY THE FILE SYSTEM 


J MOST PROGRAMS IN SYSTEM INITIALIZATION ARE DELETED AFTER 
INITIALIZATION IS COMPLETE. 


) SUPERVISOR PROGRAMS ARE LOADED IN THREE "COLLECTIONS", EACH OF 
WHICH DEPENDS ON THE MECHANISMS SET UP BY THE PREVIOUS ONE 


® MAJOR DATA BASES 


f THESE DATA BASES ARE ALL BUILT DURING THE PROCESS OF 
INITIALIZATION (EXCEPT FOR THE CONFIG DECK) AND KEPT AFTER 
INITIALIZATION IS FINISHED 


f SEGMENT LOADING TABLE (>sli>slt) 


) CONTAINS AN ENTRY DESCRIBING THE ATTRIBUTES OF EACH SEGMENT 
IN THE SUPERVISOR 
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SYSTEM INITIALIZATION OVERVIEW 


| NAME TABLE (>sli>name_table) 


f CONTAINS A LIST OF NAMES FOR EACH OF THE SEGMENTS IN THE 
SUPERVISOR 


) DEFINITIONS SEGMENT (>sli>definitions_ ) 


f CONTAINS THE DEFINITIONS SECTIONS FOR ALL THE SEGMENTS IN THE 
SUPERVISOR, WHICH ARE USED IN ORDER TO SNAP LINKS BETWEEN THE 
SUPERVISOR MODULES 


[ CONFIG DECK (>sl1>config_ deck) 


J CONTAINS A DESCRIPTION OF THE HARDWARE CONFIGURATION AND 
CERTAIN SOFTWARE PARAMETERS 


J PROVIDED TO SYSTEM INITIALIZATION BY BOS 


® SHUTDOWN -- TERMINATES THE ACTIVITIES OF THE SYSTEM IN AN ORDERLY 
FASHION 


) TWO TYPES OF SHUTDOWN: 


J NORMAL -- REQUESTED BY THE INITIALIZER, RUNS IN THE USUAL 
SUPERVISOR ENVIRONMENT 


1 EMERGENCY -- USED AFTER A CRASH, MUST MAKE THE SUPERVISOR 
ENVIRONMENT OPERABLE BEFORE PROCEEDING 
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SYSTEM INITIALIZATION OVERVIEW 


) BOTH TYPES EXIST PRIMARILY TO SHUT DOWN THE FILE SYSTEM -- THAT 
IS, TO WRITE ALL DATA IN MEMORY INTO ITS PROPER HOME ON DISK 


f INCLUDES PAGES OF SEGMENTS, VTOCES, VOLUME AND VTOC MAPS 


) SHUTDOWN ESSENTIALLY RUNS THE STEPS OF INITIALIZATION BACKWARDS , 
BUT WITH A LOT OF SHORTCUTS 
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BOS: 


MST: 


f1G DECKS 


BOOT: 


= 


M/COLD BOOT: 


SYSTEM INITIALIZATION TERMINOLOGY 


A SET OF CARDS OR CARD IMAGES USED TO INFORM THE 
SOFTWARE ABOUT THE OPERATIONAL READINESS OF TRE 
HARDWARE PRESENT, SWITCH SETTINGS AND SPECIFICATIONS OF 
SOME SOFTWARE DATA BASES (SIZE, LOCATION, ETC) 


anh oe OPERATING SYSTEM. A SIMPLE OPERATING 
SYST (A ONE CPU, UNPAGED ENVIRONMENT) OF 8 SEGMENTS 
SecueTING Toe. Fa RST- 16K OF MAIN MEMORY. BOS RESIDES IN 
THE BOS PARTITION WHEN "MULTICS”" IS RUNNING 


THE MULTICS SYSTEM TAPE CONTAINS PRECISELY ENOUGH 
INFORMATION (PROCEDURES AND DATA BASES) TO BRING A BARE 
HARDWARE SYSTEM TO MULTICS COMMAND LEVEL (ACTUALLY, 
ONLY ENOUGH OF COMMAND LEVEL TO PERFORM A RELOAD) 


THE OPERATIONAL PROCEDURE OF READING THE SEGMENTS FROM 


THE MST AND EXECUTING THE PROCEDURE/SEGMENTS THEREIN 


BOOTING THE SYSTEM WITH/WITHOUT A HIERARCHY PRESENT 


HARDCORE PARTITION: 


A RLV PARTITION FOR PAGING HARDCORE SEGMENTS CREATED 
DURING BOOTLOAD 


SYSTEM INITIALIZATION TERMINOLOGY 


DECIDUOUS SEGMENT: 
A SEGMENT READ IN AS PART OF THE BOOTLOAD TAPE AND 
PLACED INTO THE HIERARCHY. DECIDUOUS SEGMENTS ARE PART 
OF THE INITIALIZER'S HARDCORE ADDRESS SPACE AND RESIDE 
ENTIRELY IN THE HARDCORE PARTITION. THEY ARE PUT INTO 
THE HIERARCHY (>sli) IN ORDER TO BE ACCESSIBLE FROM THE 
USER RINGS 


NON DECIDUOUS HARDCORE SEGMENT: 
A PAGED HARDCORE SEGMENT NOT IN THE HIERARCHY (AND THUS 
HAS NO PATHNAME) 


ty 
oo 
Qa 
re 
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ORDINARY SEGMENTS: 
> sss >bound_p/ii_ 

> udd >MED > Kaiser >Kaiser.mbx 
> udd >Site Sa >Homan >test_pl1 
ipd} > stack_4 


iF 9) 
= DIRECTORY SEGMENTS: 
Liu >udd > udd >Site Sa faa 
= > SSS >udd >MED © 
C5 2) 
Lit => 
Te) jaa 
Lid 
REVERSE-DECIDUOUS: = 
(per-process,-per-booticad, ring 0 only} rT. 
[pd)>dseg | >sl1>stack_O.nnn = 
kst 
[pd] > ks ra) 
<. 


[pd] > pds 


NON-SUPERVISOR PROGRAMS: 
>si1>bound_command__ioop_ 
> sl1>bound_rcp_ . 


| COLLECTION 
tt 3 


DECIDUOUS: 
> sl1>bound_sss_ wired_ 
> sil >sys_info 


>sli>hes_ (all ring 0 gates) 
Cr 
we fet 
Ek E 
= 
J QO | DISK OVERLAY ABS-SEGS: < 
= <q volmap_abs__seg & 
oo = syserr_tog Ze) 
n | ® : 
ee = 
oe * = 
= % | NON-DECIDUOUS PAGED: 5 
° bound_file_system w 6 
Ss bound_system_ faults <q 
: str_seg = - 
8 os 


UNPAGED: 
sst_seg tc_data 
pxss 
bound_page_cotnrol 


bound_to_wired 


HIERARCHY 


ET ee ee cee 


SEGMENT CATEGORIES 


NON-HIERARCHY 


INITIALIZATION DATA BASES 


® THE TERM INITIALIZATION REFERS TO THE ACTIONS REQUIRED TO CREATE 
THE MULTICS ENVIRONMENT GIVEN THE EXISTENCE OF A CONFIGURATION 
DECK, AND HARDWARE CONTAINING NO OTHER DATA THAN FIRMWARE AND BOS 


® INITIALIZATION IS ACCOMPLISHED BY AN ORDERLY LOADING AND PROCESSING 
OF THE SEGMENTS RESIDING ON THE MULTICS SYSTEM TAPE (MST) 


® THE SEGMENTS OF THE MST MAY BE DIVIDED INTO THREE CATEGORIES: 


) INITIALIZATION SEGMENTS 


J ‘PROCEDURES USED ONLY FOR INITIALIZATION AND SUBSEQUENTLY 
DISCARDED 


SUPERVISOR SEGMENTS 


J DATA BASES USED DURING INITIALIZATION THAT ULTIMATELY BECOME 
DATA BASES OF Initializer.SysDaemon.z 


J PROCEDURES AND DATA BASES THAT CONSTITUTE MULTICS HARDCORE 
SUPERVISOR IN ITS ENTIRETY 


1 NON-SUPERVISOR SEGMENTS 


] THE SEGMENTS OF COLLECTION THREE ARE PRECISELY THE 
NON-SUPERVISOR SEGMENTS OF THE MST. THESE SEGMENTS ARE 
LOADED DIRECTLY INTO >system_library_1, AND ARE NOT PART OF 
THE RING ZERO SUPERVISOR | 
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INITIALIZATION DATA BASES 


® BOOTLOAD PROCESSOR 


] ONE PROCESSOR (THE BOOTLOAD CPU) PERFORMS ALL OF INITIALIZATION 
RUNNING EXCLUSIVELY IN RING ZERO 


© 


. IN THE MOST OF INITIALIZATION (COLLECTION ONE AND MOST OF 
COLLECTION TWO), THERE ARE NO PROCESSES, AS SUCH. THE 
ENVIRONMENT WHICH RUNS THERE EVENTUALLY BECOMES THE 
Initializer.SysDaemon PROCESS 


) NOTE: SINCE THE Initializer.SysDaemon DOES NOT LOGIN LIKE OTHER 
USERS, IT DOES NOT APPEAR IN THE NORMAL USER TABLE, CONSEQUENTLY 
IS NOT VISIBLE TO THE who COMMAND 


® STRATEGY OF INITIALIZATION: BOOTSTRAPPING 


] THE FIRST PROCEDURES RUN IN AN’ ENVIRONMENT DEVOID OF ALL 
SOFTWARE ASSISTANCE 


f EACH NEW MECHANISM (SEGMENTATION, STACKS, SYMBOLIC LINKING, 
PAGING, ETC) 1S MADE OPERATIVE AS SOON AS POSSIBLE TO ENRICH THE 
ENVIRONMENT IN WHICH FURTHER MECHANISMS ARE MADE OPERATIVE 


| MANY MECHANISMS HAVE SUBSYSTEMS THAT CONTROL THEM AND THESE 
SUBSYSTEMS ARE NORMALLY INITIALIZED BY CALLING A SPECIAL ENTRY 
POINT IN THE SUBSYSTEM WHICH PERFORM SUCH TASKS AS: 


) CREATING TABLES WHOSE SIZES ARE DETERMINED BY DATA SPECIFIED 
IN THE "CONFIG" DECK 


| THREADING OF RELEVANT LISTS 
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INITIALIZATION DATA BASES 


) SEGMENTS ON THE MST ARE ARRANGED IN SUCH AN ORDER THAT THE 
EARLIER SEGMENTS ALLOW AS MANY MECHANISMS AS POSSIBLE TO BE USED 
IN LOADING AND PROCESSING OF THE LATER SEGMENTS 


J FOR THIS PURPOSE (AND BECAUSE THE SIZE OF THE MST IS POTENTIALLY 
LARGER THAN MAIN MEMORY), THE MST IS DIVIDED INTO FOUR PARTS 
KNOWN AS COLLECTION ZERO, ONE, TWO AND THREE 


J INITIALIZATION CAN BE VIEWED AS THE LOADING AND PROCESSING OF 
COLLECTION ONE, COLLECTION TWO, AND COLLECTION THREE, IN TURN 


® THE ADDRESS SPACE OF INITIALIZATION (MINUS THE INITIALIZATION 
SEGMENTS) BECOMES THE GLOBAL SUPERVISOR ADDRESS SPACE OF MULTICS 


IS ADDRESS SPACE IS "CLONED TO BECOME 


H sUs) 
SPACE OF NEWLY CREATED PROCESSES BY DUPLICATING 
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ENVIRONMENT PASSED TO INITIALIZATION 


® THE FIRST SEGMENT OF COLLECTION ONE IS THE BOUND SEGMENT 
bound_bootload_1i 


® AT THE TIME CONTROL IS TRANSFERRED TO bound _bootioad_i, IT IS 
REQUIRED THAT BOS HAS INITIALIZED MAIN MEMORY AS FOLLOWS: 


f THE IOM MAILBOX MUST BE AT LOCATION 1400 AND CONTAIN THE CHANNEL 
AND DEVICE NUMBER OF THE TAPE DRIVE ON WHICH THE MST IS MOUNTED 


) THE CONFIG DECK (AS PRODUCED BY BOS) MUST RESIDE AT LOCATION 
14000 THRU 15777 


. THE BOS TOEHOLD AND FLAGBOX MUST BE AT LOCATION 10000 THRU 11777 


J THIS ONE PAGE CONSTITUTES ALL KNOWLEDGE THAT MULTICS HAS OF 
BOS 


J TRANSFERRING CONTROL TO THE START OF THE BOS TOEHOLD WILL 
CAUSE: 


) FIRST 64K OF MAIN MEMORY TO BE FLUSHED OUT TO THE BOS 
PARTITION 


| THE BOS OPERATING SYSTEM TO BE READ INTO THE FIRST 64K OF 
MAIN MEMORY 


1 CONTROL GIVEN TO BOS 


| THE REMAINDER OF MAIN MEMORY MUST CONTAIN ZEROES 
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COLLECTION 0 


® THIS CONSISTS OF-THE SEGMENTS WHICH ARE DEFINED TO BE PRESENT IN 
THE INITIAL ADDRESS SPACE 


. THESE SEGMENTS ARE EMPTY, AND OVERLAY SPECIFIC REGIONS OF MAIN 
MEMORY. THEY ARE DEFINED SO THAT bound_bootload_1 CAN KNOW WHAT 
SEGMENT NUMBERS TO USE FOR WHAT DATA 


f THE COLLECTION ZERO SEGMENTS ARE dseg, fault _vector, 
iom_mailbox, config_deck, dn355_mailbox, bos _toehold, flagbox, 
slt, and name_table 


) SEE SECTION 5, NAME / ADDRESS SPACE MANAGEMENT, FOR THEIR 
DESCRIPTIONS 
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COLLECTION 1 


® COLLECTION i CONTAINS ALL OF THE PROCEDURES AND DATA 


NECESSARY TO MAKE PAGING OPERATIVE 


® BASIC STEPS OF COLLECTION 1 LOADING AND INITIALIZATION: 


BASES 


1 bound_bootload_i GAINS CONTROL FROM BOS, IN ABSOLUTE MODE, AND 


PERFORMS THE FOLLOWING: 


f LOADS THE REMAINDER OF ITSELF INTO MAIN MEMORY 


J ESTABLISHES INTERIM FAULT AND INTERRUPT VECTORS © 


J INITIALIZES THE INITIALIZATION DSEG, AND ENTERS APPENDING 


MODE 


J READS THE REMAINDER OF COLLECTION 1 INTO MAIN MEMORY 


(INCLUDING A SEGMENT NAMED bootstrap2) 


] bound_bootload_1 TRANSFERS TO bootstrap2 


f bootstrap2 PERFORMS THE FOLLOWING: 


) CREATES A STACK FRAME IN THE SEGMENT "inzr_stk0" 


J CALL THE APPROPRIATE PROCEDURES TO PRELINK THE SEGMENTS OF 


COLLECTION 1 


1 SETS UP THE PL/I ENVIRONMENT AND CALLS THE FIRST PL/I 


PROCEDURE “initializer” 
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COLLECTION 1 


J initializer (A SUPERVISOR SEGMENT) , ACTUALLY CALLS 
real_initializer TO DO THE REAL WORK. ALL THE REST OF 
INITIALIZATION TAKES PLACE VIA CALLS IN real_initializer 


i FOR DEBUGGING URPOSES, THERE IS A MECHANISM IN 
real_initializer WHICH CAN BE USED TO STOP AT ANY OF THOSE 
CALLS BY SETTING A VALUE IN THE PROCESSOR SWITCHES 


] THE MAJOR peepee Rea ne PERFORMED IN THE REST OF COLLECTION 
ONE ARE: 


f INITIALIZE THE SCU, CLOCK, AND CPU CONTROL MECHANISMS, 
CHECKING THE SWITCHES AND THE ADDRESSABILITY OF MEMORY 


J INITIALIZE FAULT AND INTERRUPT PROCESSING. INITIALIZE THE 
CONSOLE AND SYSERR MECHANISMS 


J INITIALIZE PRIMITIVE TRAFFIC CONTROL (WAIT FOR SINGLE 
EVENTS). INITIALIZE THE SST 


) INITIALIZE AND CHECK THE DISK CONFIGURATION. AT THIS POINT, 
IT BECOMES POSSIBLE TO TAKE PAGE FAULTS, AND ALL FURTHER DISK 
I/O IS DONE BY PAGING 


) CHECK THE ROOT VOLUMES SPECIFIED ON THE ROOT CARD, AND 
INITIALIZE THE HARDCORE PARTITION MECHANISM. THIS ALSO 
INCLUDES CREATING THE PARTITIONS AND VTOC IN A COLD BOOT 


f MAKE SEGMENTS PAGED -- AT THIS POINT, ALL PAGED SUPERVISOR 
SEGMENTS ARE COPIED INTO THE HARDCORE PARTITION, AND ACCESSED 
BY THE NORMAL PAGE FAULT MECHANISM. COLLECTION ONE ENDS HERE 
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COLLECTION 2 


® COLLECTION TWO - THE REST OF SUPERVISOR INITIALIZATION 


f READ IN THE REST OF THE SUPERVISOR SEGMENTS FROM TAPE AND 
INITIALIZE THE REST OF THE SUPERVISOR DATABASES 


| WHEN COLLECTION TWO IS FINISHED, THE INITIALIZATION ENVIRONMENT 
HAS BECOME Initializer PROCESS, AND IT CALLS OUT TO RING ONE TO 
START OP THE ANSWERING SERVICE 


| THE FOLLOWING MAJOR STAGES TAKE PLACE IN COLLECTION TWO: 


) COLLECTION TWO IS READ FROM TAPE (STILL USING A SPECIAL 
PROCEDURE, tape_reader, WHICH DOUBLE-BUFFERS) 


f THE AND CONDITION SIGNALLING AND HIGHER LEVEL FAULT 
MECHANISMS ARE INITIALIZED 


f HIGH LEVEL FILE SYSTEM MECHANISMS ARE INITIALIZED: THE VTOC 
MANAGER, VOLUME DUMPER BIT MAP, SCAVENGER, SEGMENT TRAILERS, 
LOGICAL VOLUME MANAGEMENT, DIRECTORY LOCKING 


) TRAFFIC CONTROL IS FURTHER INITIALIZED, AND AN IDLE PROCESS 
IS CREATED FOR THE RUNNING CPU 


J SYSERR LOGGING (TO THE SYSERR PARTITION) IS INITIALIZED. ALL 
SYSERR MESSAGES GENERATED AFTER THIS POINT WILL GO IN THE LOG 


) THE FILE SYSTEM ON THE RPV IS "ACCEPTED", AND THE ROOT 
DIRECTORY INSPECTED (OR CREATED, IF THIS IS A COLD BOOT) 
{ AFTER THIS POINT, THE CONTENTS OF THE HARDCORE PARTITIONS 


ARE FIXED, AND ALL FURTHER RECORD ALLOCATION AND FREEING 
IS DONE FROM THE PAGING REGIONS OF THE FILE SYSTEM VOLUMES 
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COLLECTION 2 


) DECIDUOUS SEGMENTS ARE SPLICED INTO THE HIERARCHY 
f STACK SHARING IS INITIALIZED 


[ THE REST OF THE SEGMENTS, COMPRISING COLLECTION THREE, ARE 
READ, DIRECTLY INTO THEIR PLACES IN THE HIERARCHY (>s1i) 


{ THE USER VISIBLE SUPERVISOR I/O MECHANISM (iei) Is 
INITIALIZED, AND THE SPECIAL SUPERVISOR TAPE READER IS SHUT 
DOWN . 


) TRAFFIC CONTROL IS FULLY INITIALIZED BY CREATING IDLE 
PROCESSES FOR THE OTHER CPUS AND STARTING THEM 


f ALL INITIALIZATION SEGMENTS ARE NOW DISCARDED, AND WHAT HAS 
BECOME THE Initializer.SysDaemon PROCESS CALLS init_proc AND 
BEGINS EXECUTION IN RING ONE 


7» 
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COLLECTION 3 


® COLLECTION THREE IS NOT PROPERLY A "COLLECTION" AT ALL, BUT JUST A 
TERM USED TO DESCRIBE THE BEGINNING OF Initializer AND ANSWERING 
SERVICE INITIALIZATION 


J MANY THINGS HAPPEN BETWEEN FIRST LEAVING RING ZERO AND LOGGING 
iN THE -PIRST USER. MOST HAVE NOTHING TO DO WITH THE FILE 
SYSTEM. THE FEW MOST INTERESTING ONES ARE: 


J VOLUME ACCEPTANCE - THE NON-ROOT VOLUMES ARE INSPECTED AND 
ACCEPTED INTO THE HIERARCHY. THEIR CONFIGURATION CAN BE 
CHANGED BY USE OF OPERATOR COMMANDS 


[ delete_old_pdds - THE PROCESS DIRECTORY AND DECIDUOUS 
SEGMENTS LEFT OVER FROM THE PREVIOUS BOOTLOAD(S) ARE DELETED 

f THIS MUST BE DONE AFTER THE HIERARCHY IS FULLY AVAILABLE, 
SINCE NON-RLV VOLUMES MAY HAVE BEEN USED FOR PROCESS DIRS 


J VOLUME SCAVENGER AND QUOTA SALVAGER PROCESSES MAY BE STARTED 
AT THIS TIME, IF THERE ARE INCONSISTENCIES IN THE HIERARCHY 
CAUSED BY PREVIOUS CRASHES 
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NORMAL SHUTDOWN 


WHEN THE SYSTEM IS SHUT DOWN, IT MUST BE DONE IN AN ORDERLY MANNER 


vy Be IS ACCOMPLISHED, MORE OR LESS, BY RUNNING THE STEPS IN 
INITIALIZATION BACKWARDS: 


J CRAWLOUTS ARE DISABLED. ONCE SHUTDOWN BEGINS, IT CAN'T BE 
STOPPED 


) THE Initializer SWITCHES TO RUNNING ON THE BOOTLOAD CPU, 
TRAFFIC CONTROL IS DISABLED, AND THE “OTHER CPUS ARE STOPPED 
AND DELETED. 


] LOCKING IS DISABLED AT THIS POINT, SINCE THERE IS NOW ONLY 
ONE PROCESS AND ONE PROCESSOR RUNNING 


J. ALL THE DISK DRIVES ARE EXERCISED, TO DETERMINE IF ANY ARE 
BROKEN AND CANNOT BE SHUT DOWN 


J ANY VOLUME SCAVENGES IN PROGRESS ARE STOPPED AND ABANDONED 


AT THIS POINT, NORMAL SHUTDOWN IS READY TO SHUT DOWN THE FILE 


SYSTEM, AND ALL THE NORMAL MECHANISMS ARE ASSUMED TO BE 
OPERATING. 


THE Initializer SWITCHES TO inzr_stkO (WHERE IT ALL STARTED) AND 
CALLS shutdown_file_ system 
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FILE SYSTEM SHUTDOWN 


® FILE SYSTEM SHUTDOWN CONSISTS OF FORCING ALL DATA OUT OF MEMORY TO 
ITS HOME ON DISK: 


{ ALL PAGES ARE WRITTEN 


. SEGMENTS ARE DEACTIVATED, AND THEIR VTOCES UPDATED 


{ VOLUMES ARE DEMOUNTED, AND THEIR LABELS UPDATED 


f FILE SYSTEM SHUTDOWN TAKES THE FOLLOWING STEPS: 


f ALL MODFIED PAGES ARE WRITTEN TO DISK. THIS IS DONE SEVERAL 
TIMES DURING THE COURSE OF SHUTDOWN 


J STACK_0 SEGMENTS ARE DEACTIVATED AND DISCARDED 
] THE deactivate for demount PROCEDURE IS CALLED TO DEACTIVATE 


ALL OTHER SEGMENTS AND UPDATE THEIR VTOCES 


J THIS IS DONE BY WALKING THE AST HIERARCHY FROM THE BOTTOM 
UP, DEACTIVATING A SEGMENT, ITS SIBLINGS, AND ITS PARENTS, 
Bre. 


J THIS IS DONE TO ENSURE CONSISTENT QUOTA VALUES IN VTOCES 
AFTER SHUTDOWN, BECAUSE QUOTA MUST BE UPDATED FROM THE 
BOTTOM UP 


f LL VOLUMES ARE DEMOUNTED, THEIR VOUME AND VTOC MAPS UPDATED, 
AND LABELS CHANGED TO INDICATE SUCCESSFUL DEMOUNT 


. THE ORDER IS NOT IMPORTANT, EXCEPT THAT THE RPV GOES LAST 
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FILE SYSTEM SHUTDOWN 


f MEMORY IS FLUSHED AGAIN 
J iIF ANY DRIVES WERE INOPERATIVE, THIS IS ANNOUNCED, AND THE 
RPV IS NOT DEMOUNTED 
] THIS MAKES IT POSSIBLE TO FIX THE BROKEN DRIVE AND DO AN 
_ EMERGENCY SHUTDOWN TO FINISH SHUTDOWN 


f IF THERE WERE NO PROBLEMS, THE RPV IS DEMOUNTED AND MEMORY IS 
FLUSHED ONE LAST TIME. ALL RELEVANT INFORMATION IS .NOT ON 
DISK . 


f AT THE END OF FILE SYSTEM SHUTDOWN, ALL CONSOLE MESSAGES ARE 
ALLOWED TO COMPLETE, AND THE SYSTEM RETURNS TO BOS 
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EMERGENCY SHUTDOWN 


® EMERGENCY SHUTDOWN IS DONE AFTER A CRASH OR SHUTDOWN FAILURE 


f LIKE NORMAL SHUTDOWN, THE MISSION OF ESD 1S TO SHUT DOWN THE 
FILE SYSTEM, AND IT DOES THIS BY MAKING THE SYSTEM WORK WELL 
ENOUGH TO CALL shutdown_file_system 


f UNLIKE NORMAL SHUTDOWN, IT CANNOT ASSUME THAT NORMAL MECHANISMS 
ARE OPERATIONAL, AND MUST MAKE THEM WORK FIRST 


f AFTER THE SUPERVISOR IS MADE OPERATIONAL, EMERGENCY SHUTDOWN 
TRANSFERS TO THE NORMAL FILE SYSTEM SHUTDOWN 


{ THE FOLLOWING STEPS ARE TAKEN TO REANIMATE THE SUPERVISOR: 
1 . EMERGENCY SHUTDOWN STARTS OUT RUNNING IN ABSOLUTE MODE 


J IT ENTERS APPENDING MODE, FINDS THE PRDS FOR THE PROCESSOR IT 
IS RUNNING ON, SETS IT UP AS ITS STACK 


J ALL CRITICAL LOCKS (PAGE TABLE, APT) ARE FORCIBLY UNLOCKED. 
TRAFFIC CONTROL IS DISABLED. THE PROCESSOR RUNNING IS NOW 
THE ONLY ONE, AND LOCKS ARE UNNECESSARY 


1 . THE CONSOLE AND SYSERR MECHANISMS ARE RESET 


f SUPERVISOR I/0 SUPPORT, IN PARTICULAR THE DISK DIM, IS 
REINITIALI ZED 

] THE STATE OF PAGE TABLES AND THE CORE MAP IS MADE CONSISTENT 
1 THIS IS DONE BY pc_recover_sst AND CAN BE DONE ONLY 


BECAUSE ALL OF PAGE CONTROL 1S CODED TO FOLLOW PROTOCOLS 
ABOUT THE ORDER IN WHICH TO UPDATE RELATED DATA 
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EMERGENCY SHUTDOWN 


{ BECAUSE OF THIS, IF PAGE CONTROL IS INTERRUPTED AT ANY 
POINT, IT IS POSSIBLE TO DETERMINE WHAT IT WAS DOING AND 
COMPLETE THE OPERATION 


THIS STEP IS CRUCIAL TO BEING ABLE TO TAKE PAGE FAULTS 
LATER IN SHUTDOWN 


| BECAUSE THERE IS NO GUARANTEE THAT THE PROCESS WHICH CRASHED 
THE SYSTEM {AND THUS, THE ADDRESS SPACE WHERE ESD IS RUNNING) 
IS NOT DEFECTIVE, ESD REBUILDS ITS PDS FROM THE template_pds 


] ESD SWITCHES TO THE inzr_stk0 AND CALLS wired_shutdown 
| ALL THE ABOVE STEPS WERE DONE IN ALM. wired shutdown IS A 
PL/I PROCEDURE 


J THE VTOC BUFFER IS CHECKED TO SEE WHETHER ANY OPERATIONS WERE 
IN PROGRESS. IF SO, THOSE VOLUMES ARE MARKED (IN THE PVT) TO 
INDICATE THAT THEY MAY HAVE INCONSISTENCIES 


MEMORY IS FLUSHED 


f THE VTOC MANAGER IS REINITIALI ZED 


{ AT THIS POINT, THE SUPERVISOR SHOULD BE WORKING WELL ENOUGH 
TO RUN shutdown file system. FROM NOW ON, EMERGENCY SHUTDOWN 
FOLLOWS THE SAME PATH AS NORMAL SHUTDOWN 


f =IF EMERGENCY SHUTDOWN FAILS, FOR TAKING A FAULT OR SOME OTHER 
REASON, IT CAN BE RETRIED INDEFINITELY 


J SHUTDOWN IS MARKED COMPLETE IN VOLUME LABELS, AND THESE ARE NOT 
UPDATED UNTIL THE . VERY END. THUS, NO HARM CAN COME FROM 
RETRYING ARBITRARILY 


) ESD TRIES TO CORRECT ALL THE PROBLEMS THAT MIGHT ARISE. 
BECAUSE OF THE COMPLEXITY OF THE SUPERVISOR, IT DOES NOT 
ALWAYS GET ALL OF THEM 
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File System Salvagers 
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OVERVIEW OF SALVAGERS 


@® FUNCTION 


ENSURE THE CONSISTENCY OF THE FILE SYSTEM DATABASES AND PERFORM 
PERIODIC PREVENTIVE MAINTENANCE OPERATIONS 


{ THERE ARE SEVERAL SALVAGERS, EACH WITH A DIFFERENT FUNCTION 


f BECAUSE OF THE COMPLICATED INTERACTIONS THEY HAVE WITH THE REST 
OF THE FILE SYSTEM, THE SALVAGERS ARE PERHAPS THE MOST 
COMPLICATED SINGLE PROGRAMS IN THE SUPERVISOR 


f SOME SALVAGING IS DONE AUTOMATICALLY, WHEN THE SYSTEM DETECTS AN 
INCONSISTENCY. OTHER SALVAGE OPERATIONS ARE EXPLICITLY 
REQUESTED, BY PRIVILEGED USERS. 


| EXCEPT FOR SUPERVISOR BUGS, THE ONLY TIME DAMAGE OCCURS THAT 
REQUIRES SALVAGING TO FIX IS AFTER A CRASH WHERE EMERGENCY 
SHUTDOWN FAILS | 


® THE SALVAGERS: 


f DIRECTORY SALVAGER 


J CORRECTS INCONSISTENCIES IN DIRECTORY SEGMENTS BY REBUILDING 
THEM 


Jf THIS IS THE ONLY SALVAGER INVOKED AUTOMATICALLY IN USER 
PROCESSES: ANY ATTEMPT TO LEAVE RING ZERO WITH A DIRECTORY 
LOCKED FOR WRITING WILL CAUSE IT TO BE SALVAGED 
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OVERVIEW OF SALVAGERS 


J DIRECTORY SALVAGING ALSO RECLAIMS WASTED SPACE IN THE 
DIRECTORY, AND IS RUN PERIODICALLY TO COMPACT DIRECTORIES 


| QUOTA SALVAGER 


J CORRECTS INCONSISTENCIES IN THE QUOTA SYSTEM 
NYO Fie ATES BETTE esdless C (Ash. 


f PHYSICAL VOLUME SCAVENGER 


f RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION FROM THE 
VTOCES ON A VOLUME, THEREBY RECLAIMING ANY RECORDS OR VTOCES 
WHICH MIGHT HAVE BEEN LOST 


f RUNS ENTIRELY ONLINE WHILE THE SYSTEM IS UP FOR USERS (NEW IN 
MRIOL) 


) THIS TYPE OF DAMAGE IS USUALLY BENIGN, SO RUNNING THE 
SCAVENGER CAN BE DELAYED. 


1 PHYSICAL VOLUME SALVAGER 
J RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION 


f RUNS ONLY DURING INITIALIZATION, AND ‘THEREFORE DELAYS CRASH 
RECOVERY 


J NOW USED ONLY FOR RARE CASES WHERE THERE IS NOT ENOUGH FREE 
SPACE LEFT FOR THE SCAVENGER TO RUN. IN THESE RARE CASES, IT 
IS INVOKED AUTOMATICALLY BY SYSTEM INITIALIZATION. 


[ SWEEP PV 
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OVERVIEW OF SALVAGERS 


) DELETES UNUSED VTOC ENTRIES WHICH HAVE NO DIRECTORY ENTRY 
POINTING TO THEM 


UNS ENTIRELY IN USER RING, EXCEPT FOR ACTUALLY READING VTOC 
ENTRIES AND DIRECTORY ENTRIES 


. PURELY A HOUSEKEEPING FUNCTION, AND RUN ONLY RARELY. 
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DIRECTORY SALVAGER 


® THE DIRECTORY SALVAGER IS USED FOR TWO MAIN PURPOSES: DAMAGE 
CORRECTION AND STORAGE RECLAIMATION 


@ DIRECTORY DAMAGE ocivukS Gs needed 


f DAMAGE CAN OCCUR IN A DIRECTORY FOR SEVERAL REASONS: 
J DISK 1/0 ERROR WRITING BAD DATA TO A DIRECTORY SEGMENT 


| SUPERVISOR BUG ede 
Gut ao +( CAs Com CAUS O VA C o$Ss5 ee.) ,%. 


] CRASH WITHOUT ESD, WHERE THE DIRECTORY WAS UPDATED, BUT NOT 
FULLY WRITTEN TO DISK 


J ACTUAL’ DAMAGE TO DIRECTORIES IS COMPARATIVELY RARE, BUT: 


IF A FAULT OCCURS FOR ANY REASON WHILE A USER HAS A’ DIRECTORY 
LOCKED, THE SYSTEM ASSUMES THE DIRECTORY COULD BE AT FAULT, 
AND SALVAGES = \fuaS@rtenT 


. THIS SORT OF SALVAGING IS DONE BY THE online _salvager 
PROGRAM, WHICH IS INVOKED DYNAMICALLY BY verify lock IFA 
PROCESS ATTEMPTS TO LEAVE RING ZERO ("CRAWL OUT") WITH A 
DIRECTORY LOCKED vSer wvessame 


J ORDINARILY, THERE IS NOTHING WRONG, AND THE SALVAGER JUST 
CHECKS OVER THE DIRECTORY 


| IF THE DIRECTORY IS DAMAGED, IT IS "REPAIRED" AS WELL AS 
POSSIBLE 
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DIRECTORY SALVAGER 


Owy APPlies +0 Pra ces ding hyo eT qe Sea at jaast Suey t!S bain 
UNFORTUNATELY, THE MOST COMMON FORMS OF DAMAGE DESTROY THE 
DIRECTORY HEADER SO THAT NO REPAIR IS POSSIBLE, AND THE 
DIRECTORY MUST BE REINITIALIZED AS EMPTY 
Wer teally Tpue@y Only Ge frowss dies. 


® STORAGE RECLAIMATION 


f DIRECTORY SPACE CANNOT ALWAYS BE EFFICIENTLY RE-USED, AND 
UNUSABLE SPACE ACCUMULATES AS ENTRIES ARE CREATED AND DELETED 


f aiIT IS NOT PRACTICAL FOR THE SYSTEM TO COMPACT DIRECTORIES 
WHEN THIS HAPPENS, SINCE THIS COULD CAUSE MAJOR RESOURCE 
CONSUMPTION, AND CAUSE EXPENSE. FOR RANDOM PROCESSES 


f INSTEAD, THE DIRECTORY SALVAGER IS PERIODICALLY RUN IN 
Salvager.SysDaemon PROCESSES TO REBUILD ALL THE DIRECTORIES 
IN THE HIERARCHY, COLLECTING ALL FREE SPACE 


) THIS IS DONE BY CALLS TO hphcs_Ssalv_directory 


] IF THE Salvager PROCESSES DETECT DAMAGE, IT IS CORRECTED AS 
WELL 


f DEMAND DIRECTORY SALVAGING IS USUALLY ALSO INSTRUCTED TO LOOK 
FOR AND CORRECT "CONNECTION FAILURES" 


J A CONNECTION FAILURE IS A DIRECTORY BRANCH WHICH INDICATES 
A FREE VTOCE, OR A VTOCE WITH A DIFFERENT UID THAN THE 
BRANCH. THIS MEANS THAT THE DIRECTORY AND VTOC ARE 
INCONSISTENT 


] CONNECTION FAILURES ARE USUALLY DELETED BY DEMAND 
SALVAGING (THIS IS AN OPTION) 


] ONLINE SALVAGING DOES NOT DELETE CONNECTION FAILURES 


BECAUSE IT IS NOT ALWAYS POSSIBLE TO IDENTIFY THEM 
PROPERLY DuRING AN ONLINE SALVAGE 
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DIRECTORY SALVAGER 


f DEMAND DIRECTORY SALVAGING CAN ALSO BE USED BY SYSTEM 
MAINTENANCE PERSONNEL WHEN THERE APPEAR TO BE DIRECTORY PROBLEMS 
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® QUOTA SALVAGING CORRECTS INCONSISTENCIES IN THE HIERARCHY OF 
QUOTA-USED VALUES 


] THESE INCONSISTENCIES ARISE AFTER A CRASH WHERE ESD FAILS: 


A SEGMENT (>udd>a>b) IS DELETED, FREEING PAGES, AND THE ASTES 
OF ITS PARENT (>udd>a) AND ITS PARENT'S PARENT (>udd) ARE 
UPDATED TO REFLECT THIS DECREASE IN QUOTA USED ° 


THE VTOCE FOR >udd>a IS WRITTEN TO DISK DURING NORMAL 
OPERATION. THE VTOCE FOR >udd IS NOT 


THE SYSTEM CRASHES, AND NO ESD IS PERFORMED 


WHEN THE SYSTEM COMES BACK UP, THE VTOCE FOR >udd IS 
INACCURATE: IT CLAIMS THAT RECORDS ARE STILL IN USE, WHEN IN 


. FACT THEY WERE FREED 


IF A NEW SEGMENT (>udd>a>c) IS NOW CREATED, IT MAY SPURIOUSLY 
CAUSE A RECORD QUOTA OVERFLOW ON >udd. 


J QUOTA SALVAGING IS PERFORMED ENTIRELY ONLINE, WHILE THE SYSTEM 
IS RUNNING, USUALLY IN A Salvager.SysDaemon PROCESS 


THE FUNDAMENTAL PRINCIPLE BEHIND THE QUOTA SALVAGER IS THAT 
QUOTA INCONSISTENCIES CANNOT ARISE DURING NORMAL OPERATION: 
IF QUOTA IS CONSISTENT, OR INCONSISTENT BY n RECORDS, IT WILL 
STAY THAT WAY UNLESS EXPLICITLY CORRECTED 


THE QUOTA SALVAGER PROCESS WALKS THE HIERARCHY FROM THE 
BOTTOM UP, USING do_subtree, CORRECTING INCONSISTENCIES IN A 
DIRECTORY AND ALL ITS SIBLINGS, THEN IN THEIR PARENT, AND SO 
ON UP 
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QUOTA SALVAGING 


f AN hphes_ ENTRY IS CALLED TO CORRECT EACH DIRECTORY, ON THE 
ASSUMPTION THAT ALL ITS CHILDREN ARE CONSISTENT 


{ THE ACTUAL CORRECTION MECHANISM INVOLVES COMPLICATED 


MANIPULATION OF VARIOUS LOCKS. REFER TO THE Multics 
Storage System PLM (AN61) FOR A DESCRIPTION 
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PHYSICAL VOLUME SCAVENGER 


& THIS IS ALSO PRIMARILY USEFUL AFTER A CRASH WITHOUT ESD 


8 
] IT REBUILDS THE VOLUME MAP AND VTOC MAP FOR A VOLUME BY 
EXAMINING ALL THE VTOCES AND ASTES FOR SEGMENTS ON THE VOLUME 


f IT RUNS WHILE THE VOLUME IS IN USE BY USERS, AND NO INTERRUPTION 
OF SERVICE OCCURS 


| DAMAGE TO THE MAPS OCCURS AFTER A CRASH WHEN THE STOCKS, IN 
MEMORY, DO NOT GET PROPERLY UPDATED TO THE MAPS ON DISK 


f BECAUSE OF THE STOCK MANAGEMENT POLICIES, THIS iS ALWAYS 
BENIGN: RECORDS MAY BE MARKED IN-USE THAT ARE NOT, BUT IT IS 
NOT POSSIBLE FOR THE MAP TO INDICATE A RECORD AS FREE 
(REUSABLE) WHEN IT BELONGS TO A SEGMENT ON THE VOLUME 


f FOR RECONSTRUCTING THE VOLUME MAP, THE SCAVENGER WORKS BY AN 
INTERACTION WITH THE PAGE CONTROL RECORD ALLOCATION MECHANISM 


] IT BUILDS A MAP, IN scavenger_data, THAT SAYS WHAT VTOCE OWNS 
EACH RECORD ON THE VOLUME , AND THEN RESOLVES THE 
INCONSISTENCIES BETWEEN THAT AND THE MAP ON DISK 


) THE DATABASE IS WIRED FOR THE DURATION OF THE SCAVENGE, 
AND CAN BE QUITE LARGE (64K FOR AN MSU0501) 


J) WHILE A SCAVENGER IS RUNNING, PAGE CONTROL KEEPS THE 
DATABASE UP TO DATE AS IT ALLOCATES AND FREES RECORDS 


FOR VTOCES, THE PROBLEM IS MUCH SIMPLER: THE vVTOC IS SIMPLY 
SCANNED, AND ALL IN-USE VTOCES ARE RECORDED 


Not To Be Reproduced 2229 F80A 


. vtoc_ man ALSO KEEPS 


PHYSICAL VOLUME SCAVENGER 


THE TABLE UP TO DATE AS IT FREES AND 


ALLOCATES VTOCES ON THE VOLUME 


A VTOCE THAT APPEARS IN-USE MAY NOT NECESSARILY BE PART OF 


THE HIERARCHY -- sweep pv IS RUN TO TAKE CARE OF THAT 


AFTER THE NEW MAPS ARE CONSTRUCTED, THEY ARE WRITTEN TO DISK 


fiStarted 


J THE SCAVENGE RUNS ENTIRELY IN RING ZERO, BUT IT CAN BE SAFELY 
INTERRUPTED AND RESTARTED FROM THE BEGINNING AT ANY TIME 


| THE SCAVENGER ACCESSES THE VTOC USING vtoc_man 


Por SSU.RC 


THE SCAVENGER TAKES ABOUT FIFTEEN MINUTES PER VOLUME, BUT THE 
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PHYSICAL VOLUME SALVAGER 


® THIS DOES THE SAME JOB AS THE SCAVENGER, BUT CAN RUN ONLY WHEN THE 
VOLUME IS UNAVAILABLE TO USERS 


J BECAUSE IT HAS THE VOLUME ALL TO ITSELF, IT IS MUCH SIMPLER: 


J IT SCANS THE VTOC, BUILDING THE SAME SORT OF DATABASES AS THE 
SCAVENGER 


| WHEN FINISHED, IT RESOLVES INCONSISTENCIES, AND WRITES THE 
MAPS BACK TO DISK 


) THE VOLUME SALVAGER ACCESSES THE VTOC USING 
Salv_abs_seg NN 


{ THE VOLUME SALVAGER TAKES ABOUT A MINUTE AND A HALF PER VOLUME, 
BUT ALL VOLUMES MUST BE SALVAGED BEFORE THE SYSTEM CAN RUN AGAIN 


J AFTER A CRASH WITHOUT ESD, ALL VOLUMES. MOUNTED AT THE TIME OF 


f THE VOLUME SALVAGER IS LARGELY OBSOLETE TODAY. IT IS RETAINED 
TO DEAL WITH RARE SITUATIONS WHICH MAKE IT IMPOSSIBLE TO BRING 
THE SYSTEM UP FAR ENOUGH TO RUN THE SCAVENGER WITHOUT FIRST 
REBUILDING THE FILE MAP TO FREE UNUSED SPACE 
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SWEEP PV 


sweep pv ELIMINATES ORPHAN VTOCES 


AN ORPHAN VTOCE IS ONE WHICH APPEARS TO DESCRIBE A VALID 
SEGMENT, BUT DOES NOT APPEAR IN ANY DIRECTORIES 


1 ORPHANS ARE USUALLY CREATED BY CRASHES OR DIRECTORY DAMAGE 
WHERE THE DIRECTORY COULD NOT BE REPAIRED 


J ORPHANS ARE ALSO SOMETIMES CALLED "REVERSE CONNECTION 
FAILURES" 


sweep pv WORKS BY INSPECTING EVERY VTOCE ON A VOLUME, AND 
ATTEMPTING TO FIND ITS PARENT 


[ ‘THERE IS A "UID PATHNAME" IN PART 3 OF ALL VTOCES WHICH 
CONTAINS THE UIDS OF ALL ITS PARENT DIRECTORIES 


f (BY STARTING FROM THE ROOT, AND SEARCHING EACH DIRECTORY IN 
THE PATH FOR THE UID OF THE NEXT ONE, THE VTOCE CAN BE FOUND 


f «IF IT CAN'T BE FOUND, IT IS AN ORPHAN, AND SWEEP PV 
DELETES IT ve 


IT IS POSSIBLE TO "ADOPT" ORPHANS INTO A DIFFERENT PLACE IN THE 
HIERARCHY IF IT IS IMPORTANT TO RECOVER TEEIR CONTENTS, USING 
THE adopt _seg TOOL 


THE UID PATHNAME OF A VTOCE CAN BE INTERPRETED MANUALLY BY USING 
THE vtoc_pathname TOOL 
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The Initializer.SysDaemon Process 
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INITIALIZER OVERVIEW 


® FUNCTION 


{ THE SYSTEM'S INITIALIZATION, ADMINISTRATIVE AND CONTROL PROCESS 
(Initializer.SysDaemon.z), RESPONSIBLE FOR: 


J INITIALIZING THE OPERATING SYSTEM AT BOOTLOAD, FOLLOWING 
SUCCESSFUL INITIALIZATION OF THE SUPERVISOR 


J ANSWERING SERVICE (login and logout) 

| PROCESS CREATION AND DESTRUCTION 

| MESSAGE COORDINATOR (DAEMON COORDINATION) 
| SYSTEM ADMINISTRATION FUNCTIONS 


J SYSTEM ACCOUNTING FUNCTIONS 


® MAJOR DATA BASES, ALL KEPT IN >sci 
J ANSWER_TABLE 
. ABSENTEE _USER_TABLE 


| DAEMON _USER_TABLE 
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INITIALIZER OVERVIEW 


| MASTER GROUP TABLE (MGT) 

| CHANNEL DEFINITION TABLE (CDT) 

| SYSTEM ADMINISTRATION TABLE (SAT) 
| PERSON NAME TABLE (PNT) 


f PROJECT DEFINITION TABLES (PDT'S) 
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SERVICES OF INITIALIZER 


THE Initializer.SysDaemon PROCESS PERFORMS VARIOUS SERVICES 
NECESSARY FOR THE SUPERVISOR. MANY OF THEM ARE PERFORMED BY THE 
INITIALIZER PRIMARILY FOR CONVENIENCE, SINCE IT IS EASIER TO 
CONTROL RESOURCES IN A CONTROLLED ENVIRONMENT SUCH AS A SINGLE 
PROCESS THAN TO CREATE A MECHANISM WHICH CAN BE RUN IN ALL 
PROCESSES 


{ SYSTEM INITIALIZATION AND SHUTDOWN 


| THE Initializer PROCESS IS CREATED FROM THE ENVIRONMENT THAT 
INITIALIZES THE SUPERVISOR 


1 WHEN THE SYSTEM IS SHUT DOWN, THE Initializer COORDINATES THE 
ORDERLY CESSATION OF _ SYSTEM ACTIVITY AND CALLS 
hphes_Sshutdown TO SHUT DOWN THE SUPERVISOR 


J LOGICAL VOLUME MANAGEMENT 


[ THE Initializer PROCESS HANDLES ALL REQUESTS FROM USER 
PROCESSES TO MOUNT AND UNMOUNT PRIVATE LOGICAL VOLUMES 


J IT ALSO MAKES THE NECESSARY CHECKS TO ACCEPT A VOLUME INTO 
‘THE HIERARCHY OR REMOVE IT FOR DEMOUNTING 


J RESOURCE CONTROL 
J THE Initializer DOES ALL THE CONTROL, ASSIGNMENT, AND ACCESS 


CHECKING OF RESOURCES (SUCH AS 1/0 DEVICES) CONTROLLED BY RCP 


{ PROCESS CREATION AND DESTRUCTION 


‘ry 
oo 
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SERVICES OF INITIALIZER 


) THE Initializer CREATES AND DESTROYS ALL PROCESSES, SCHEDULES 
ABSENTEE PROCESSES, AND HANDLES "CONSOLE" 1/0 FROM DAEMON 
PROCESSES 


J AN IMPORTANT SERVICE OF PROCESS MANAGEMENT IS PROCESS DIR 
VOLUME MANAGEMENT, IN WHICH THE Initializer PICKS THE LOGICAL 
VOLUMES USED FOR PROCESS DIRECTORIES 


] THE Initializer ALSO HANDLES ALL PROCESS ACCOUNTING AND LOAD 
CONTROL 


| COMMUNICATIONS 


) THE Initializer MANAGES LOADING / DUMPING OF FNPs~ AND 
SOFTWARE COMMUNICATIONS MULTIPLEXERS 


f IT ALSO HANDLES ALLOCATION OF COMMUNICATION CHANNELS, BOTH 
BOR PROCESSES LOGGING IN AND REQUESTS MADE THROUGH 
dial _manager_ 


DYNAMIC RECONFIGURATION 


[<n J 


THE Initializer RUNS THE DYNAMIC RECONFIGURATION SOFTWARE, 
AND UPDATES THE SYSTEM LOAD LIMITS WHEN THE CONFIGURATION 
CHANGES . 


= 


f ACTUALLY, ANY PROCESS WITH hphes_ ACCESS CAN USE THE 
RECONFIGURATION COMMANDS, BUT ONLY THE Initializer CAN KEEP 
ALL THE ACCOUNTING DATABASES UP TO DATE 
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Metering and Tuning 


Meter and Tuning Overview. . 


Analyzing Performance Problems 
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Output From Metering Commands. 
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. METER AND TUNING OVERVIEW 
Wobab! A 1% ites d. 


® WHILE NOT A SUBSYSTEM ITSELF, METERING AND TUNING IS A POLICY AND 
CAPABILITY COMMON TO ALL OF THE SUPERVISOR'S SUBSYSTEMS 


& FUNCTION 


{ METERING (CONSISTS OF THREE ACTIVITIES) 
f ACCUMULATING DATA: THIS IS . PERFORMED THROUGHOUT THE 
SUPERVISOR BY CODE WHICH 


J RECORDS THE NUMBER OF TIMES AN EVENT HAPPENS OR A 
PARTICULAR PIECE OF CODE IS EXECUTED; AND/OR 


J RECORDS THE TIME REQUIRED TO PERFORM A TASK 
1 SUCH DATA IS STORED IN AREAS REFERRED TO AS "METERING 
CELLS” 
§ EXTRACTING DATA: | THIS IS PERFORMED BY NUMEROUS METERING 
COMMANDS WHICH (WHEN INVOKED) 
f READ AND STORE THE CURRENT VALUES OF RELEVANT METERING 
CELLS 
1 REPORTING THE DATA:: THIS IS PERFORMED BY THE METER COMMANDS. 
WHICH (WHEN INVOKED) 


J COMPARE CURRENT METERING CELL VALUES WITH PREVIOUSLY READ 
VALUES 


) PERFORM THE APPROPRIATE ARITHMETIC COMPUTATIONS UPON THE 
DATA IN ORDER TO ARRIVE AT THE DESIRED STATISTIC 


{ ARRANGE THE DATA IN A USEFUL FORMAT (A REPORT OR DIAGRAM) 
AND PRINT IT 


— 
( 
f 
'y} 
oo 
() 
Ned 
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METER AND TUNING OVERVIEW 


[ TUNING 


] CHANGING THE SYSTEM'S OPERATING 
CONFIGURATION BASED UPON THE DATA AND 
SYSTEM'S METERS 


® MAJOR DATA BASES 


{ SST HEADER, TC_DATA HEADER, ETC. 
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PARAMETERS AND /OR 
INSIGHTS FROM THE 


Pry 
oO 
oO 
oe 


ANALYZING PERFORMANCE PROBLEMS 


® MULTICS IS VERY HEAVILY INSTRUMENTED WITH MANY METERING COMMANDS 


f MOST SOLVABLE PERFORMANCE PROBLEMS SHOW UP QUITE DIRECTLY IN THE 
METERS 


J IF THE SYSTEM IS TOO SLOW, THERE ARE GOOD RULES OF THUMB TO 
FOLLOW TO LOOK FOR WHEN PROBLEM 


1 NO TWO SYSTEMS ARE IDENTICAL - THE MOST IMPORTANT INFORMATION 
YOU HAVE IS HOW THE METERS ARE DIFFERENT FROM THE WAY THEY WERE 
WHEN THE SYSTEM WAS WORKING BETTER 


J NOT ALL TUNING PROBLEMS CAN BE RESOLVED WITH SOFTWARE. OFTEN IT 
SIMPLY INDICATES THAT THERE IS NOT ENOUGH MEMORY, OR NOT ENOUGH 
DISK CAPACITY. IT IS OFTEN ‘DIFFICULT TO DETERMINE WHAT HARDWARE 
CHANGES WOULD BE MOST COST-EFFECTIVE 


® total_time_meters - THE FIRST STEP 


J total_time_meters MAY INDICATE EXCESSIVE TIME SPENT IN SEVERAL 
AREAS: ; 


) PAGE FAULTS - TOO MANY PAGE FAULTS MEAN NOT ENOUGH MEMORY, 
TOO MANY ELIGIBLE PROCESSES (max_eligible), WHICH CAUSE 
THRASHING, INSUFFICIENT DISK CAPACITY, OR INEFFICIENT 
APPLICATIONS 


) LOOK TO file_system_meters, device_meters, AND disk_meters 
FOR MORE HELP 
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ANALYZING PERFORMANCE PROBLEMS 


f SEGMENT FAULTS - TOO MANY ALMOST ALWAYS MEAN THAT THE AST 
POOLS (sst CONFIG CARD) ARE TOO SMALL 


[| LOOK TO file_system_meters (AST Pool grace time) FOR MORE 
HELP 


{ INTERRUPT - USUALLY MEANS EXCESSIVE INTERRUPT ACTIVITY EITHER 
FOR FNPS OR BECAUSE OF EXCESSIVE PAGING, BUT MAY INDICATE 
HARDWARE PROBLEMS 


[ LOOK TO interrupt_meters TO LOCALIZE IT, THEN TO 
file _system_meters and system_comm_meters 


‘| OTHER FAULT - GENERALLY INDICATES TOO MANY CONNECT OR TIMER 
RUNOUTS FAULTS, INDICATING EXCESSIVE TRAFFIC CONTROL ACTIVITY 


f LOOK pie. THE TUNING PARAMETERS (ptp) AND 
traffic_control_meters FOR MORE HELP 


. MP IDLE - INDICATES TOO MUCH TRAFFIC CONTROL ACTIVITY, 
USUALLY BECAUSE THERE ARE TOO MANY ELIGIBLE PROCESSES 
(max_eligible) AND/OR NOT ENOUGH MEMORY 


J LOOK TO THE TUNING PARAMETERS (ptp), file _system_meters, 


device_meters, disk meters, AND traffic _control_meters FOR 
MORE HELD 


1 WORK CLASS IDLE - THIS IS CPU TIME WASTED BECAUSE GOVERNED 
WORKCLASSES WERE NOT PERMITTED TO USE IT, AND NO OTHER TAKERS 
WANTED IT 


| FREQUENTLY NOT A PROBLEM, BUT MAY INDICATES A NEED TO 
READJUST WORKCLASSES (work class_meters) 


J. NMP IDLE, ZERO IDLE - INDICATE THAT CPU TIME HAS GONE TO 
WASTE BECAUSE NO PROCESSES WANTED IT. NMP IDLE MEANS THAT 
THERE ARE MORE PROCESSORS THAN PROCESSES THAT WANT CPU TIME, 
AND ZERO IDLE MEANS THERE ARE NO PROCESSES AT ALL 
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ANALYZING PERFORMANCE PROBLEMS 


J NORMALLY INSIGNIFICANT QUANTITIES - THE FOLLOWING NUMBERS 
SHOULD ALWAYS BE VERY SMALL; LARGE VALUES PROBABLY INDICATE A 
HARDWARE OR SOFTWARE PROBLEM 


PC LOOP LOCKS 
BOUND FAULTS 
TC LOOP LOCKS 
POST PURGING 
LOADING IDLE 
OTHER OVERHEAD 
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DETAILED PROBLEM ANALYSIS 


® THE MORE DETAILED METERING COMMANDS CAN BE USED TO PIN DOWN A 
PROBLEM 


f DETAILED DESCRIPTIONS CAN BE FOUND IN THE Multics Metering 
Manual (AN52) 


) THE DETAILED METERS SHOULD ALSO BE CHECKED IF THERE IS NO 
OBVIOUS PROBLEM SHOWN BY total_time_meters 


) AGAIN, THE REALLY IMPORTANT THING IS TO BE ABLE TO COMPARE 
AGAINST PREVIOUS DATA FOR YOUR SITE 


@ SOME GOOD PLACES TO LOOK ARE: 


J interrupt_meters 


] UNUSUALLY LONG DISK INTERRUPTS MAY INDICATE LOCKING PROBLEMS 
- SEE disk_meters 


1 TOO MUCH TOTAL TIME SPENT WITH DISK INTERRUPTS USUALLY MEANS 
TOO MANY PAGE FAULTS, WHICH WILL BE SHOWN IN MORE DETAIL BY 
file system_meters 


) FNP INTERRUPTS ARE TYPICALLY MUCH LONGER THAN OTHERS. TOO 
MUCH FNP INTERRUPT TIME MAY INDICATE A BAD FRONT END CHANNEL, 
BUT ‘THLS:. 1S--RARE 
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DETAILED PROBLEM ANALYSIS 


f file _system_meters 


f A SHORT PAGE LAP TIME MEANS THAT PAGES ARE NOT STAYING IN 
MEMORY LONG ENOUGH; THAT IS, THERE IS NOT ENOUGH MEMORY 


J FREQUENT PAGE CLAIM RUNS INDICATE THAT THE WRITE LIMIT IS TOO 
LOW 


f IF THE AVERAGE PAGE FAULT DURATION IS HIGH, IT CAN MEAN THAT 
THE WRITE LIMIT IS TOO HIGH, AND THAT DISK ALLOCATION LOCKS 
ARE A LIMITATION; SEE disk_meters TO CHECK 


J SHORT AST POOL GRACE TIMES MEANS THAT THE POOL SiZES SHOULD 
BE INCREASED. THIS IS USUALLY ALSO INDICATED BY TOO HIGH A 
FREQUENCY OF SEGMENT FAULTS 


{ disk_meters 

{| WHEN THE ATB 1/0 FOR A DRIVE IS TOO LOW, THE DRIVE IS A 
SERIOUS BOTTLENECK. 
f THIS OFTEN HAPPENS FOR RLV DRIVES, BECAUSE OF DIRECTORIES 
| IF PARM DIRW IS ON, IT SHOULD BE TURNED OFF 

1 TOO HIGH A PERCENTAGE OF ALLOCATION LOCKS INDICATE THAT TOO 
MANY WRITES ARE BEING QUEUED SIMULTANEOUSLY, AND MAKING IT 
IMPOSSIBLE TO GET A QUEUE ENTRY FOR READING 


? THIS USUALLY MEANS THAT WRITE LIMIT IS TOO HIGH 


) device_meters 


J «IF THE SUBSYSTEM BUSY PERCENTAGE IS TOO CLOSE TO THE DISK 
CHANNEL CAPACITY, IT USUALLY MEANS THAT THERE ARE TOO FrEW 
PHYSICAL DISK CHANNELS 
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OUTPUT FROM METERING COMMANDS 


total time meters 


@® TOTAL TIME METERS - 


OVERVIEW OF HOW THE SYSTEM 


IS USING ITS 


RESOURCES, ALSO MEASURED AGAINST NON-IDLE TIME 


af 
\ 
Total metering time 0:20:36 nc Or 
% ZNI AVE py ws 
Be ae, : > \Boo 
Page Faults 6.55 (230.424) OF g 
PC Loop Locks - Oas2 0.4 39934209 ; 
PC Queue 0.86 4 348.946 oak lo, 
Seg Faults 1.74 (@.90 9579.170 [Gepost ovr 
Bound Faults 0.15 05 17826208 nn eee, 
Interrupts 9.02 > 1723504 i sets “CONN 
Other Fault 8.45 ; o ool’ 
Getwork 4.54 G3 660.550 
TC Loop Locks O20 0.22 247.788 
Post Purging 0.36 are) 1407132 
MP Idle 0.70 cD 
Work Class Idle 0.98 ne 
Loading Idle 0.26 0.17 
NMP Idle 8.84 
zero Idle 0.00 
ther Overhead 0.03 0.04 


Virtual CPU Time 62.53 


Pare Fan lT¢ 


Ley PATS. “Sy 


Thee 


Clock, Ave farsh 


Paes) 1S \C IS Cleck lnPTives fer Fa PS mt Fi lp Sys EIS 


For Vohe “TH rPgh. ns, \e, K. MALE TE lagT 


2) Fresy Clepk AVE. (FF > [¥oo Th 
bot le WeaTs Ther check A istvacTor$ 


Chock £10 nS ySTo~ maNOKS FH aly oa 


}E 

laTellyvers Dis ie She pe 
Llecte 

Che cq 

JeTearkK SEY — Beleek 

a 
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OUTPUT FROM METERING COMMANDS 


interrupt meters 


& INTERRUPT METERS - COUNTS & TIMING FOR ALL 1/0 INTERRUPTS 


Total metering time 0:20:28 


IOM Ch © Int Avg Time % CPU Name 
A 6y lei 2.043 0.00 IOM A special 
A 10. 379 tm0S 0.01 prtb 
A Ss $253 3.436 0.65 Enpe 
A 14, i9 0.788 0.00 ope 
A 16. 26248 1.347. 0.72 tapa 
A 27. 128 1320 0.00 tapa 
A 18. 13097 S.383 1.43 fnp b 
A 20. 21041 0.860 0.37 dska 
A 24. 2881 0.860 0.05 dska 
A 22. 8486 0.877 0.15 easkb 
A 23% Zo] 0.964 0.01 adskb 
A 24. 17896 0.895 0.33 askb 
i. 125s 2515 0.943 0.05 dskb 
A 26. 10486 0:.857 0.18 adgska 
A De 225 0.899 6.00 dska_ 
A 26. 2-717 6.845 G.43 dske 
A 29. 2313 C.849 0.04 dske 
A 30. 9975 6.845 Osi? <dske 
A 31. 225 O.767 0.00 dskc 
B 14. 236 0.877 0.60 inp <¢ 
B: 15. 6Si7 > sess 0.47 inp f 
B 18. 3547 3.543 0.26 fnpa 
B 19. 13667 3.435 0.96 fnpe 
B 20 22013 0.882 0.39 adskb 
B 21 4745 0.863 0.08 dskb 
B. 22% 6054 6.861 0.11 Gska 
B 23. 60 0.925 0.00 dska 
B 24. 15946 0.867 0.28 dska 
B 25. 989 0.841 0.02 dska 
B 26. 12757 0.863 © 0.22 dskb 
B. 27% 1020 0.903 0.02 dskb 
BS: “26% 5i76 0.838 0.09 adskce 
Be Zot 30 0.653 0.00 dskc 
B “30, 16582 0.823 0.28 dske 
B Si. 825 0.841 0.01 dske 
“B. 32. i764 0.825 0.03 dske 
Chan 262506 1.464 Teou 
Ovhd 258932 0.230 iy2i 
Total Z25E932 Lets $03 
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OUTPUT FROM METERING COMMANDS 


file system meters 


YSTEM_METERS - DISPLAYS MISCELLANEOUS METERING INFORMATION 
POLE SYSTEM 


IT ONLY PARTS RELEVANT TO SEGMENT CONTROL INCLUDED HERE: SEE TOPIC 
& (PAGE CONTROL) FOR THE REST : 
Tote] metering time 0:20:02 
# ATE 
Activations 1945 1.123 sec. 
seqfault e693 i.2h1 sec. 92.995% of ei} 
makeknown raP 16.251 sec 7.095% cf a!) 
cirectories 4 12.527 sec. $.20L% of 21} 
Deactivetions 1956 1.139 sec 
Demand ceactivate 
attemots 3 £30.857 sec. 
Seg Faulis 5080 0.237 sec 
fault L331 QO.279 sec. 84.8624 of Sec Faults 
cal} 745 1.56% sec 5.13B% of Sec Faults 
activations 969 1.241 sec. 9.075% of Seg Faults 
Bound Fauvits 220 5.466 sec. 
Setfaults bubs 268.191 msec. 
access a2 28.6353 sec O.537% of setfauits 
ASTE Trickle 129 8.652 sec. 
Steps 427 251.040 msec. 
Skios © 301g 0.399 sec. 70.4845 of Stens 
ens efi L.438 sec. &.985% of Skips 
mem 1083 1.110 sec. 35.909% of Siions 
init 1os2 0.724 sec. 55.106% of Skips 
Searcnes 0 0.000 sec. 
Cleanups 105é 1.139 sec. 0.1 % of real time 
Force writes 3 400.857 sec. 
paces written 3 400.857 sec. 
Lock AST 18422 0.065 sec. 
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OUTPUT FROM METERING COMMANDS 


file system meters 


AVE/lock gz 
AST locked 4.833 msec. 7.4 
AST lock waiting 1.601 msec. 255 
AST Sizes 4 16 64 256 
Number . 270F 601 221 74 
Need 819 202 208 34 
Steps 2341 645 Tio9 154 
Ave Steps Zao 2 JZ =e, 4.5 
Lap Time(sec) 873.8 422065 25.543 577.9 
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OUTPUT FROM METERING COMMANDS 


file system meters 


® FILE SYSTEM_METERS - 
FOR THE FILE SYSTEM 


f ONLY PARTS RELEVANT TO PAGE CONTROL INCLUDED HERE; 


(SEGMENT CONTROL ) 
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Average steps 


Total metering time 
$ 
Needc 62654 
Ring 0 faults 
PDIR faults 
Level 2 faults 
DIR faults 
New Pages 
Volmap_seg 0 
zero pages 770 
Laps 105 
Steps 361483 
Skip 322555" 
wired Ble Goons 
used 109719 
mod 140356 
fc pin 37717 
GL. pin 23726 
3419 pages, 139 wired. 


FOR THE REST 


0:20:02 


ATB 


19.194 
HL66639 
50.607 
234006 
7.645 
14.661 
0.000 


156L3779 


11.453 
Sy321 
S228 

408 2764 

10.960 
saepatcae) 

31.884 

50.686 


S270 


sec. 


dP de? dP dO oo FJ 


msec. 


msec. 
sec. 

msec. 
msec. 
msec. 
msec. 
msec. 
msec. 
msec. 


89.231% 
3.428% 
34.016% 


A? EnOQa 
tOeWVIVUVS 


11.693% 
7.356% 


- 


of 
of 
of 


act Cc 


Wd be 


of 
of 


DISPLAYS MISCELLANEOUS METERING INFORMATION 


SEE TOPIC 7 


oo 


ue 


OUTPUT FROM METERING COMMANDS 


device meters 


@® DEVICE METERS - DISPLAYS SUMMARY OF 


x I/O ACTIVITY FOR ALL DISK 
SUBSYSTEMS 


Total metering time 0:20:13 

dska dskb dske dskd 
Prior Page I/O 18571 17743 462 1273 
ATB 65.334 68.383 2626.240 953.121- 
Other Page I/O 6525 5135 16 696 
ATB 185.949 236.284 75832.692 1743.280 
ATB Page I/O . 48.347 53.034 2538 .332 616.212 
Prior VTOCE 1/0 934 895 38 304 
ATB 1299.061 1355.668 31929.554 3991.194 
ATB I/O 46.612 SiwOS7 * 2351.401 6334798 
% Busy 76 74 0 4 
Avg. Page Wait 47.289 46.197 20.341 24.666 
Avg. Page “Wait 176.082 201.023 36.996 61.704 
Avg VTOCE Wait 41.138 37.610 38.595 29.090 
Avg. Page I/O T 35.619 38.314 20.050 22.482 
Avg. VTOCE I/O T Si4439 32.277 37.060 26.606 
EDAC Corr. Errs 0 0 0 0 
Errors 0 0 0 i 
Fatal Errors 0 0 0 e) 
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OUTPUT FROM METERING COMMANDS 


disk meters 


® DISK_METERS - DISPLAYS 1/0 ACTIVITY TO DISK DRIVES 


f ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 


; : ¢ yor PAL Xe 
Total metering time Or20e.12 Vian tee ert 
Naver ot 
Subsystem dska Count. Waits sWaits Avg. Wait(ms.) 
call locks 26005 217 0.83 0.259 
run locks 2 0 0.00 0.000 
interrupt locks 252796 428 * 92 o1 0.206 
allocations 26001 Aries © 0.000 
ELS hen Gor es Sree 
Drive Reads Writes Seek ATB ATB 
Distance ae Writes I/O 
o. 
1 269 67 214 4508 18102 3609 peH Sec TRusy 
3 362 243 109 3350 £994 2004 
4 3035 nigel 184 3925 9258 2756 
5 547 165 180 2217 DeoU 1703 
6 631 165 i161 1922 ~ F350 i523 
7 0 0 0 0 0 0 
8 5843 2187 122 207 554 151 
) 366 ii6é 153 3313 10455 2516 
1i 3501 1431 200 346 847 245 
12 0 0 0 0 0 0 na aeae 
16 7158 2508 135 169 483 125 > ver euey 
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OUTPUT FROM METERING COMMANDS _ rer 
disk queue 7 

rE you |, 

{ oSe one eae, AL Le K 

CP adle only ed wee 
Lose | Soe | vn tv& 

@ DISK_QUEUE - DISPLAYS I/O QUEUE FOR A DISK SUBSYSTEM 

SoU eT 
AS eth.cied 


[| ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 
i CRF cy Cva 
Got ess \—- 


Connects = 2604781, 1359725, 677321, 309367, “e'4#le. 
123430, 40159, 10227, 1969. 


P RW VP DV SECTOR MEM 

0 W P 24 1350330 27304000 

0 W PRP 9 1020150 4432000 

0 W.P 16 1204130 36246000 

0 W P 16 314370 27306000 

0 W P 16 314430 34166000 

Hors mith retA TIwe Mwe°TonS eee ae ea pie eee aT ee 
os, NY, 
\ Yeu should hes O Lesical Cage tor Pach atm 


: Seek Vime YK JranSOr Tere, 
Abe msr - 


OoSohe 


looyica 
Lhanag i. 


GS oF MAL Lb Aish Gres 
So CON THe oy Subsys tens isnt bh neces ary, 


n$ 


(OG-caly 
A Seb Syyor 
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OUTPUT FROM METERING COMMANDS 


print configuration deck 


= PRINT_CONFIGURATION_DECK - 
CONTAINS INFORMATION ABOUT DISK LOCATIONS, THE RLV, AND PARTITIONS 


DISPLAYS >sli>config deck, WHICH 


) ONLY THE PART OF THE CONFIG DECK RELEVANT TO VOLUME MANAGEMENT 
AND DISK CONFIGURATION IS SHOWN HERE 


root 


part 
Dart 
part 


prph 
chnl 


prph 
ehns 


prph 
chnl 


prph 
chnl 


prph 
ens 


' mpc 
mpc 
mpc 
mpc 
mpc 
mpc 


dska 


bos 
dump 
log 


dska 
aska 


askb 
dskb 


dske 
dske 


aske 
dske 


aGskf 
askf 


mspa 
MmSDD 
mspc 
mspd 
mspe 
mspf 


16. 


dska 


d 
1 


dska 


dska 


ra 
a 


b 
b 


wo 


oo 


© 


451i. 
451. 
607. 
607. 
451. 
6075 
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20. 
26. 


20. 
26. 


28 5. 


30". 
ae 


34, 


32. 
34. 


Moon ow 


skb 


6. 
Od 
6. 


N MN 


hd 


Pao 


oP om om iB oP 


dskb 23. dskb 24. dska &. 


“82% 
30. 2 b 28 2 
. (Oe 
° 16. 
a 24. 4 
b 24. & 


OUTPUT FROM METERING COMMANDS 


print configuration deck 


@® DISK CONFIGURATION CONFIG CARDS 


§ ROOT 


f IDENTIFIES THOSE VOLUMES IN THE ROOT LOGICAL VOLUME WHICH 
HAVE HC PARTITIONS, USED BY THE SUPERVISOR FOR PAGING OF 
SUPERVISOR SEGMETNS ° 


{| PART 
{ IDENTIFIES THE LOCATIONS OF CERTAIN IMPORTANT PARTITIONS 


f ONL PARTITIONS NECESSARY FOR MULTICS CPERATIONS 
IDENTIFIED, NOT ALT PARTITIONS 


ve 
vw 
a | 


f HC PARTITIONS ARE LOCATED BY THE KOOT CARD 


f  PRPH DSKn, CHNL 


J IDENTIFY PHYSICAL 1/0 CHANNEL PATHS FOR ACCESSING DISK DRIVES 


1 MPC 


J IDENTIFY PHYSICAL CONNECTIONS TO MICROPROGRAMMED DISK 
CONTROLLERS 
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OUTPUT FROM METERING COMMANDS 


list vets 


e@ c!IST_VOLS - DISPLAYS & TABLE OF ONLINE VCLUMES, THEIR LOCATION, ANC 

SPACE UTILIZATION 
Drive Recoras Left % VTOCEsS Left & Avg PV PB/PD LV Name 

Size Name 

dske 47 6450L 54730 8&5 13440 11356 84 4 alphaOl pb pd  Alphe 
dske_i8 6450L 553289 85 13440 11352 84 L alph2e0Z ob pd Riphe 
eske C5 36428 5305 15 8400 2662 Z 5 mul03 pd pd Multics Pubs 
eske 06 36428 4323 12 BL00 2365 28 5S mul0l pb pd = Multics Fups 
dskb_ 19 36428 4632 13 8400 2813 33 5 muld2 pb pd Multics Pubs 
dskb_26 36429 13690 38 BL00 4326 52 5 mul05 pb pd Multics Pubs 
dskb_27 6429 4S72 13 8400 2333 2 5 mulls po pd Multics Fuss 
csk2_ 01 36268 be8O 1! g009 450 5 3 pubdi 5 pd Public 
cskée_03 36268 3588 10 9200 1917 11 5 pub0d7 p> pc Public 
dske_ Ob 36268 4500 12 §200 884 10 3. pubds pb pd Public 
eske_ 09 26268 bE16 13 S200 864 9 3 pubdz pb od Public 
eskb i7 59259 426: 12 $200 i002 11 3. puoGs pb pd Public 
Gske_‘é 3626£ 3846 11 §200 5349 § 3. pubde pe pds Pupiic 
aske_ 13 64504 254 O 3640 5536 21 B reli Release 
dskc_ 1k 64504 269 O 13480 5214 39 7 relc2 Release 
dskc_0i 64595 43631 68 i3b490 10032 75 6 xpud0l leper Xpublic 
eske_C2 64563 45502 71 13440 9838 73 #& xpubd?2 Db Xpublic 
cske_C3 64503 &237b $6 135440 9829 73 6 xpusd? po Oust re 
dske_OL 64503 42591 68 13446 S785 73 5 xpub0L pb Aoudol Te 
askc_09 6450, 580i0 90 13440 1229L 92 6 xpuDds pb Xpublic 
dske_ 10 64504 5578 B88 i13b40 12457 92 7 xpupds po Apubiic 
eske 21 64503 23947 37 13440 6446 48 5 ypubOl ppb Youblic 
gske 22 64503 23744 37 13640 6194 46 5S ypubd2 ~~ ob Ypublic 
eske_28 64503 23794 37 13446 6185 LE § ypup05 ob Ypuplic 
esic 3¢ i503 2hil1 37 13240 6481 48 5 yousde pb Youblic 
eskc. 6 64503 11723 18 $i34L0 6149 6 7 zpubdi pb pa Zpublic 
eskc_O08 64505 11665 12 13440 6429 48 r -2ou5G2 oS: ps Loos 
dske_23 6i50L S777 15 13440 6094 45 7 zpub03 pb pd Zpublic 
dskc_ 2h 6450L 11805 18 13440 6141 4&6 7 zpubd04 pb pd Zpublic 
aske_25 64504 11514 18 13440 7407 55 8 zpub05 pb pd Zpublic 
dske_2¢ 64504 12958 20 13440 7149 53 § zpub0G © pb pd Zpublic 
dske_ 06 37082 =68S53) «220-5100 3797 7h 22 «listOl pb pd list} 
dska_12 37562 6046 16 2735 957 35 17 Jlist02 pb itst_2 
dska_07 37309 6825 18 4000 2107 53 16 Jlist63 pb histo 
cska_08. 36209 3827 11 7000 491 ri ub roots pb root 
dska_11 36209 8597 2b 7090 4181 §90 9 roots pb root 
cska_lé 3123 2292 S 9000 3476 39 5 rpv DD root 
Gsks_ 23 36208 4888 13 7O0O 455 7 i rocts pb root 
cskb 2i 390209 3C97 g JOOO 238 3 Lb rootd pd root 
dskp_ 25 36350 4LL83 12 7900 223 3 L root2 po root 
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OUTPUT FROM METERING COMMANDS 


traffic eontrol queue 


@ TRAFFIC_CONTROL_QUEUE - DISPLAYS THE CURRENT CONTENTS OF THE 
SCHEDULER QUELVES, USEFUL FOR GETTING AN IDEA OF WHAT THE USER 
PROCESSES ARE DOING 


I FIRST PART OF OUTPUT IS ELIGIBLE QUEUE: 


avg = 13, elapsed time = 1247 sec, 64 active last !5 sec. 


flags otu apf temax te ts ti tssc event d ws we process 
rWLE(d) 148 6946 2097 37 0 0 -0.001 0 0 6 O Initializer 
xLED (c) 15 fill 1000 910 2012 1897 0.001 00 i1 6 Sibert 
rLlé (d) 1& 1379 500 83 0 0 -0.009 00 0 4& Giaz2z 

rLle (d) j 823 500 13 0 QO -0.009 00 6§& 8 JCrow 

wl (d) 13 534 590 422 0 0 §.918 316537 0 3 3 Ginteli 
xWLED (a) 6 108 1600 £95 2054 200% 0.0106 00 13 6 Brunelle 
wLe (d} i 864 1000 5 0 510 0.016 504631 0 46 6 Wreck 
wwlE (b) 46§ 2734 1800 315 3510 8000 6.015 224641 0 ie 3 Seretz 
wLeé (d) ay 686 500 60 8) 0 2.007 165111 0 3 & Towle 
wLE (bp) 12 52¢ 500 53 0 0 0.005 71 0 3 2 Kress 
wLE (d) 6s 1895 500 21 0 0 0.001 177022 0 O 2 OPCTL 
xLEB (b) 12 ' 872 500 85 0 0 0.0065 0 06 0 3 Pandoif 
rLeé {d) é/ 3279 500 6) 0 0 -0.006 06 C 23 Leckey 
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f SECOND PART IS REALTIME, 


REALTIME QUEUE: 


INTERACTIVE QUEUE: 


WORKCLASS 2 
“ WORKCLASS 3 
: 289 
ig 13i 
WORKCLASS 4 
WORKCLASS 5 
WORKCLASS” 6 
WORKCLASS 7 
= 5 
WORKCLASS & 
WORKCLASS 9 
WORECLASS iC 


WORKCLASS 11 9 


Not To Be Reproduced 


QUEUE: 
QUEUE: 
3326 
25.8 
QUEUE: 


QUEUE: 


OUTPUT FROM METERING COMMANDS 


traffic control queue 


credits 
credits 
1000 
1000 
credits 
credits 


credits 


credits 
—6500 


576 ms. 


242 ms. 
0 0 503 
0 4010 8000 


0.218 
0.128 
= 2601 ms. 
= 4000 ms. 


= ©5563 


C 0 0 
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0 
0 


0 


0 
0 


0 


22 
0 


2 


3 Dupuis 
3 Falksenj 


7 Saccasi 


INTERACTIVE, AND ALL WCRKCLASS QUEUES: 


OUTPUT FROM METERING COMMANDS 


traffic control meters 


8 TRAFFIC_CONTROL_METERS - DISPLAY THE STATE OF THE SCHEDULER 


] OUTPUT COMES IN THREE PARTS, SHOWN OUT OF ORDER HERE: 


,1 QUEUE LENGTHS AND RESPONSE TIME ~ THESE ARE WEIGHTED AVERAGES 
OVER THE LAST FIFTEEN SECONDS. 


J ACTIVITIES VERSUS DEPTH - HOW DEEP THE TRAFFIC CONTROLLER HAD 
TO SEARCH TO FIND A SCHEDULABLE PROCESS 


J MISCELLANEOUS COUNTERS AND FREQUENCIES OF VARIOUS EVENTS 


Total metering time 0:20:34 
Ave queve length 16.52 
Ave eligible 13332 
Response time 0.264 sec 


DEPTH SPF TBPF %GTW TBS CPU 


1 12.0 22.8 10.8 11.6 8.1 
2 41-8: 2220 9.2 12.2 7.4 
3 10.8 24.9 8.7 14.1 8.0 
4 10.2 27.9 8.5 15.2 8.4 
5 9.5 29.8 8.3 15.5 8.4 
6 8.4 33.5 7.8 16.5 8.4 
7 7h 36.3. ~.7)3> “16.8 8.0 
8 30.0 48.6 39.5 16.8 .43.3 
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Not 


OUTPUT FROM METERING COMMANDS 


traffic control meters 


COUNTER 


Interactions 
Loadings 
Blocks 
Wakeups 
Schedulings 
Lost priority 
Priority boosts 
I/O boosts 
Wait Page 
Walt PTL 
Walt Other 
Total Waits 
Notify Page 
Notify PTL 
Notify Other 
Total Notifies 
Get Processor 
Pre-empts 
Getwork 
Retry getwork 
Extra notifies 
Last EN event 
Last NTO event 


ALARM CLOCK METERS - 
TIMER FACILITY (HARDCORE INTERFACE FOR timer_manager_) 


Total metering time 


No. alarm clock sims. 


Simulation lag 
Max. lag 
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4 
~ 


TOTAL ATB 
TOT Q2255 
a2162 0.102 
14082 0.088 
36078 0.034 
125915: 0.098 
1 1234.756 

0 0.000 

378 24156 
127040 9.219 
75691 16.313 
S1512 38.693 
234643 5.262 
128954 Te070 
7o691 164313 
25530 48.747 
229975 92.369 
245856 5.022 
94235 t3e103 
338802 3.644 
4986 0.248 
2949 0.419 

000000000071 
033022237767 
DISPLAYS 


sec 
sec 
sec 
sec 
sec 
sec 
sec 
sec 
msec 
msec 
msec 
msec 
msec 
msec 
msec 
msec 
msec 
msec 
msec 
sec 
sec 


+ /INT 


L6o20 


1.578 


T>.326 
9.489 
4.001 

29.415 


a a = 


INFORMATION ABOUT THE USER ALARM 


2172 


0320331 


5.245 msecs. 
1.7340314e4 msecs. 
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® PRINT TUNING PARAMETERS Cs 


PARAMETERS. 


OUTPUT FROM METERING COMMANDS 


print tuning parameters 


ie PRINT VALUES 
MOST CONTROL THE SCHEDULER 


FOR SYSTEM CONTROL 


Current system tuning parameters: 


tefirst 

telast 

timax 

priority sched_inc 
min _eligible 

max eligible 

max batch _elig 
working set factor 
working set ~addend 
deadline mode 

int_q enabled 
post_purge 
pre_empt_sample time 
gp_at_notify 
gp_at_ptinotify 
process _ initial 
quit_priority 
gv_intecration | 
realtime_ io_priori:y 
realtime io deadline 


‘realtime_ io quantum 


| THESE ARE 
IF THE 


"IN 
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notify. timecut_ interval 
notify_ timeout _ _severity 
write limit 


TERNAL", 


stack_truncation 
stack_truncation_always 


Stk. trunc _dDlock_avg_factor 


trap_ invalid_ masked _ 
meter_ast_locking 
checksum_filemap 
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NORMALLY NEVER CHANGED, 
-all CONTROL ARGUMENT IS GIVEN 


0.5 seconds 
i. seconds 

8. seconds 

80. seconds 
2% 

20. 

0 a 
0.5 

0 

opaes 

on 

on 

0.04 seconds 
ors 


0. seconds 
0.005 seconds 
20. seconds 

0 

724 


AND ONLY PRINTED 


on 
off 
0.25 
off 
onda 
on 


OUTPUT FROM METERING COMMANDS 


work class meters 


e WORK_CLASS_METERS - DISPLAY THE VARIOUS WORKCLASS PARAMETERS, AND 
SHOW WHAT RESOURCES EACH WORKCLASS 1S CONSUMING. 


Tota! metering time 0:20:38 
WC XGUAR &MAX &TCP V/ELIG PW IRESP IQUANT RESP QUANT P MR I LCG. 
C ce Ostz 3 0.26 -2.10 OeZ6. 22% POR! Wit 
! : 0.05 } 0.25 0.75 0.50 1. FOR ! RTrime 
2 rir 15. O.44 1} PO | System SysAdm OPR FEZ 
3 wae 4u. O.45. 1 ° PO | SysProg SysDdev 
i 9. 14 4. 0.26 1 PO SEner 
5 2c. 2". 0.46 1 PO | HEngr 
6 12. 6. 8. 0.25 1 P 0 MkKzUS Mtr or Metee 
7 3. Ts 4. 0.36 1 PO OS$-Cc 
§ 6. C, 0.12 1 PO | Of fAutO 
S re 8. ex C.62 1 FO Mise Mfg 
10 Se 0. 0.55 1 Po | Other 
a L. ee Oxdee- PO | Special 


TCFU percents (X%GUAR) control non-reeltime work_classes. 
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® RESPONSE METERS 


Total metering time 


WO ---Thinks/-- 
=--Queues<<- 
# Avg 


0 86 2.70 


92 


O Ov 


015 


QUTPUT FROM METERING COMMANDS 


respons meters 


- DISPLAYS RESPONSE 
INTERACTIONS, ON A PER-WORKCLASS BASIS 


0:20: 36 


~---Response Times by VCPU Range---- 
Range- 


-VCPU 
From 


kot To Be Reproduced 


To 


# 
Int 


113 
3 
3 
119 


34 
2 
36 
626 


Avg 
VCPU 


TIME, 


’ Avg 


RT 


0.42 
5.51 
14.96 
0.91 


— S- OO 
° e ° 
m- O10 
vse a Oo 


OO ter | 


Ow d & 
~~ AO ee LO 


‘ 
he Oo 


Wr ~i ty ON 


aT AD E- 


BASED 


Resp 
Fact 


9-34 
10.00 
6.15 
7.76 


(ON TERMINAL 


Load Controi Group 


Init 


RT ime 


System SysAdm OFR FED 


SysPreog Sysdev 


Stngr 


HEngr 


FOE 


OUTPUT FROM METERING COMMANDS 


respons meters 


6 Li60 23.65 0.00 0.50 S77 0.05 2.25 20.91 —Mktus MKtFor MktEs 
2245: (0258 0.50 1.00 24 0.64 4.95 7.74 
1.00 10.00 ié 2.89 13.86 6.29 
Siiniaiar < semen 1027 “0.20 12.3924. 36 
y Zo2 14.65 0.00 0.50 292. 0.08 1s563- 20:17 DS=CC 
287 0.98 0.50 _ 1.00 9 0.71 9$,03 22.66 
1.00 10.00 17) 2.04 14.76, 7.24 
LOG: - So see 1 12,22°89.99. 9.45 
Sates Sse 319. 0.24 2.81 22.56 
8 io “2e89 0.00 0.50 79 0.06 0.31 5.45 OffAuto 
7&4 0.05 0.50 1.00 2 0.60 6.40 10.62 
ee00t.:00 1 3.20 6.73 2.10 
Soe SeSee 82 0.11 0.54 4.94 
S ee eee 0.00 0.50 SO .O.id 2.23 24007 Mise Mig 
S56 0.30 0.50 1.00 id O69: S574 -6292 
3.00 10.C0 oe Caco iaeeOe B30 
San Syese 204 Qsd3" “22050 Se76 
30 Leo wee 0.00 0.50 10.. Ostde ds85 23682 “Cohes 
E 0.23 2.06 10.00 iy 3oe60 Se ete, 20.05 
Ree ses oe, il 0.45 4,88 10.89 
nye Bo) iets 0.00 0.50 #25. 0203 “0.50 25.32 Special 
420 9.16 o.50 1.00 a OsS2 “3.61. (65:22 
1.00 10.00 &. (e625 11,40: 6190 
Pree es eee, 454 0.05 06.63 11.93 
ore Soe. 2iws C.00 0.50 6454 6.07 0.77 11.40 
6292" 20.25 G50 1200 Zit 0.68 #2552. 6.570 
Lect 10.00 ds. pee aoe5e. D268 
£0.00 99.99 2S. 2627 Fee oo 2432 
Te ee 6857 0.24 1.5 6,29 
86797 calls to meter_response_time 283 invalid transitions. 
OverheaG = 0.09% ( 0.052. ms./cail) 
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OUTPUT FROM METERING COMMANDS 


system performance graph SPG 


@ SYSTEM PERFORMANCE GRAPH - GIVES A aren sere OF SYSTEM 


ACTIVITY, SAMPLED PERIODICALLY _ - ourke 
Shiv! { 
Kae, ayn) le Zyl wh 
&c8 ‘ 
: 7 04/02y783 | 1114.3 est Sat 


up= 04/01/83 0855.6 est, SyS_ hours= 26.3, \icpyu_hours= 78.9 
cpu= 3, pages= 3419, min_e= 3, max_e= 16, /wsa= 0, wsf= 0.50, 


tefirst= is; telast= “0. 50, timax= 32. 
1115.00 Qe Ove wri KEKE REPRKKKKE | KKKKKE MI CHS Ane DV 
1116.00 Qe eR RERERRERK | KKERRKREK | RKI LI tS y S DV 
1117.00 Q*ex***eee/ eee ittpp| +. y| ‘ DV 


1118.00 Q*tex*eeeene | eeeeeEe Itt DSt. y | 
1119.00 QexeeRRREK | RHKKKRHKR (RAKE TL 


1120.00 Qexteeeeee | RAREARARE | HEREER IE 7 
1121.01 Q*ex*eeeee | eeeeEKI LE DD ty l 
1122.00 Qex*eeeeee | RARRAERER | REEL TED ly 
1123.00 Qex#*xeeee | HeeRKERER I AEMI+ES y 
1124.00 Q*texkeeeee | keeeREAEE AIL L+DS Ly 
1125.00 Q*ex#texeee | eeexeeeeeEMILi+tps Ly 
(1126.00 Qtereeteee eeeeITLititpst. oy | 


1127-200 ol eae Semen we age y | 
QE SEER RREK | RERARKEKEE | KEELE 


1128.60 Q* iiittp 
1129-00 Oe HREEKKEKK | KKEKREKRKEEE | KREG SRE A CLARE PAI CeO Y 
1130.00 Qe KRREEKEK | KKEKRREKE RRR PKKEKE zFLIICED ly 
1131.00 Oe BRREEREEK | KREKERKKKEEKE Kd de ee TEAS TATE | 
1132.00 Qe ke xexKKE HREKRRERREK | KEK RARER [REEF VILE ly 
1133.00 rQ*x****exe KRAeEKKKEEK | RK AAERELP LIES y 
1134.00 Qe kx exKEKE RRREKEREREK | KRELEKREKRE *eeiityp y 
1135.00 Qe . KRREREREKK | KRELREKEESE REKKEKEEKEL IC y 
1136.00 Qe kxeRKEKK KRREREREREE | KEK RRREKEVITLtCCS y | 
1137.00 COR RREREKE KREKEKKER | EK TEER (RRA Ve LS y 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


e Ge e€ © ee © oS oo @ @© © @ © @© #@: 9 CP 2e 0 © @ © 28 
O 
<4 


1138.01 Qexeexxees HRRKKRAKE | RRKERRRER LLL OD y DV Mulk store 
1139.00 xe GEA TL bat tee RkKAEKEKKKI TES y DV _\Nae tl 
4740;0 pie fin RE | Weakeeee |eeedeeeeei ii ttpp y D VP a| 

TES onse Died Eve + bond Dick to hey a 
VOaREV Contes! peters BEG Us \ 
NES 
é TG USee , eee 
nea pias She a S reason 
See Some Vene - Joadk CLT re 
(mi dale UNITS Veet 


qt yars 14 Adeve 
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OUTPUT FROM METERING COMMANDS 


system performance graph 


[| SOME CHARACTERS INDICATES PERCENTAGES OF SYSTEM TIME SPENT IN 
VARIOUS ACTIVITIES. OTHERS INDICATE ACTUAL VALUES 
| PERCENTAGES 


1 BLANK - USER PROCESSING. RING ZERO TIME BETWEEN "y" AND 
THE RIGHT MARGIN, USER RING BETWEEN "s" and "y" 


| SYSTEM SERVICES - SEGMENT FAULTS ("s"), PAGE FAULTS ("p"), 
TRAFFIC CONTROL ("t"), INTERRUPTS ("i") | 


f IDLE TIME - MP IDLE ("m"), NMP IDLE ("*"), ZERO IDLE 
(BLANKS ON THE LEFT) 
f OTHER VALUES (RELATIVE TO THE LEFT MARGIN) 


f TRAFFIC CONTROL QUEUE LENGTHS - READY QUEUE ("gg"), 
ELIGIBLE QUEUE ("e") 


) USER COUNTS - NUMBER OF USERS ("+"), LOAD UNITS ("-") 


f TRAFFIC CONTROL VALUES - RESPONSE TIME nr J OUlTS PER 
MINUTE ("0"), SCHEDULINGS IN TEN SECONDS ("S" 


Lf] 
© 


1/O TRAFFIC - DISK I/O PER 100 MILLISECONDS ("D"), VTOC 
I/O PER 100 MILLISECONDS ("V") 
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@® METER GATE - SHOWS TIME 


(HES. ETC.) 


OUTPUT FROM METERING COMMANDS 


meter gate 


SPENT CALLING THROUGH SUPERVISOR GATES 


Metering since 04/01/83 0855.6 est Fri. 


Total non-idle time at 04/02/83 


Gate meters for hes_: 
7 hr. 35 min. 54 sec. or 19.180% spent in calls through gate. 


calls pent 


902768 4&.50 
13857 2.29 
442912 1.19 
435510 1.01 
165154 0.97 
120204 0.83 
20620 0.51 
60796 0.59 
45464 0.45 
337615 0.40 
532081 C.35 
4085 0.35 
42080 0.33 
59354 0.32 
103629 0.32 
61851 0.32 
48621 0.31 
31637 0.26 
150703 0.26 
67267 0.20 
14851 0.20 
21051 0.18 
30337 0.18 
6288 0.17 
247420 0.16 
14024 0.16 
476759 0.16 
13601 0.13 
14860 0.13 
13496 0.13 
28194 0.12 
23725 «0.11 
1b16 0.11 
13941 0.10 
28696 0.10 
13558 8969.05 
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avg 


pwait 


0.02 
2.28 


e 


(oo meonl NN ioekeweleKoleoleloeleoeloemelelemone 
OOroao0oroaoacgoaoaorOoOnrwysooonow 
MEF ODWHs Be NOIWWWNHONOWW EN 


1101.9 est Sat = 39 Hr. 36 min. 57 sec. 


total calls’ = 6294028. 


entry name 


tty_write 
list_dir 
tty_read 
tty_order 
inttiate 
make_ptr 
make_seg 
truncate seg 
status_long 
set_alarm_timer 
read events 
Star_dir_list_ 
list_acl 
status_for_backup 
tty_get_line 
tty_write_wnole_string 
status_minf 
set_max_lengeth_seg 
terminate noname 
tty_read echoed 
guota get 
get_link_target 
initiate count 
delentry_seg 
wakeup 

Status_ 
level_set 
dir_quota_read 
list_dir_acl 
get_max_length 
make_entry 
set_bce_seg 

star_ 
get_access_ class 
status mins 
list_inacl_ali 


29 FROA 


Not 


12881 0.08 
£6180 0.08 
206 , 0.07 
1109005 0.07 
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OUTPUT FROM METERING COMMANDS 


8.50 
Zee 
493.77 
0.09 


meter gate 


Oa3? 
0.01 
S379 
0.00 


get_user_effmode 
tty_read_with_mark 
Star_list_ 
level_get 


OUTPUT FROM METERING COMMANDS 


meter gate 


J HPHCS AND i0i_ ARE THE OTHER SUPERVISOR GATES THAT CONSUME 
SIGNIFICANT RESOURCES 


Metering since 04/01/83 0855.6 est Fri. 
Total non-idle time at 04/02/83 1102.7 est Sat = 39 hr. 37 min. 59 sec. 


Gate meters for hphes_: total calis = 70604L. 
O hr. 29 min. 51 sec. or 1.256% spent in cails through gate. 


31893 
L 


-01 0.690 0.00 set_kst_attributes 
.O1 14598.71 8.00- ade_scu 


calls pent avg pwait entry name 
863 0.57 $28.77 5.40 destroy_process_ finish 
911 0.24 381.04 15.09 create_proc 
5944 0.20 48.34 1.04 dir_quota_read 
8326 0.05 8.47 0.04 tty_write_force 
5946 0.05 1 eee | 0.00 quota_read 
105 0.04 500.68 0.00 flush_core 
Zig Si. OL = 208.832 2=— 0.17) =0F Jush_ast_poo!l 
1753 0.02 16.94 C.76 star_ 
55935 0.02 oe # 0.00 set_backup_dump_time 
0 
0 


Metering since 64/01/83 0855.6 est. Fri. 
Total non-idie time at 04/02/83 1103.0 est Sat = 29 hr. 38 min. 22 sec. 


Gate meters for ioi_: total calls = 245985. 
Onr. 12 min. 14 sec. or 0.515% spent in calls through gate. 


calls pent avg pwait entry name ' 
243976 0.50 2.9% 0.00 connect 
248 0.01 65.91 2.09 workspace 
733 0.00 0.58 0.00 get_special_status 
533 0.00 0.54 0.00 set_event 
322 0.00 0.59 O.14 set_status 
105 0.00 0.55 0.00 timeout 
3 0.00 4.38 0.00 set_channel_ required 
5 0.00 0.65 0.00 get_detailed_ status 
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(End Of Topic) 
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Memory Addressing/Management 
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CONVENTIONAL MEMORY 


STRUCTURE 


@ i-DIMENSIONAL ADDRESS SPACE USED BY THE SYSTEM 


Not To Be Reproduced Lard: F8O0A 


CONVENTIONAL MEMORY 


CHARACTERISTICS 


SPACE DIVIDED INTO REGIONS OF VARIOUS SIZES, ONE REGION PER 
PROCESS /JOB/USER 


REGIONS ARE: 
f PROTECTED FROM ONE ANOTHER BY A BAR OR BY PROTECT KEYS 


J SUBDIVIDED INTO POOLS OF STORAGE USED FOR: PROGRAMS, 1/0 
BUFFERS, MEMORY ALLOCATION AREA, AUTOMATIC VARIABLES, STATIC 
VARIABLES 


1-DIMENSIONAL ADDRESS SPACE WIRED DIRECTLY ONTO REAL MEMORY 


PROGRAMS MUST BE LOADED INTO REAL MEMORY 
J MEMORY ALLOCATION FOR REGION 
f PROGRAMS AND BUFFERS ALLOCATED WITHIN REGION 


[ PREPARATORY ADDRESS MODIFICATION (ADDRESSES MUST BE MODIFIED TO 
REFLECT LOCATION WITHIN THE REGION) 
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CONVENTIONAL MEMORY 


CHARACTERISTICS 


@® LINKAGE EDITING REQUIRED 


ALL SYMBOLIC REFERENCES MUST BE RESOLVED - IMPLYING THAT ALL 
REFERENCED PROGRAMS MUST BE LOADED REGARDLESS OF WHETHER OR NOT 
THEY ARE ACTUALLY NEEDED AT RUN TIME 


® EXAMPLES: GCOS, IBM OS/MFT, IBM OS/MVT 
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CONVENTIONAL MEMORY 


PROBLEMS 


SYSTEM ADDRESS SPACE LIMITED TO SIZE OF REAL MEMORY 


USER ADDRESS SPACES (REGIONS) ARE SMALL. THIS MEANS: 


PROGRAMS MUST BE WRITTEN TO FIT INTO SMALL REGIONS 


SMALL REGION PROGRAMS OFTEN OPERATE LESS EFFICIENTLY IN THEIR 
USE OF CPU TIME THAN A SIMILAR PROGRAM DESIGNED FOR A LARGE 
REGION . 


BECAUSE SMALL REGION OPERATION IS PROGRAMMED IN, SUCH PROGRAMS 
CANNOT TAKE ADVANTAGE OF MORE MEMORY WHEN IT CAN ' BE MADE 
AVAILABLE 


PROGRAMMER MUST WASTE INGENUITY (AND SYSTEM. RESOURCES) TO MAKE > 
PROGRAMS RUN IN A SMALL REGION: 


J WRITING OVERLAY PROGRAMS 
f DIVIDING REGION INTO OPTIONAL-S1ZE POOLS 


] PROGRAMMING MECHANISMS TO EXTEND OR SWAP-OUT POOLS WHEN THEY 
OVERFLOW 


PROGRAMMER TIME WASTED WHEN PROGRAMS MUST BE CONVERTED TO TAKE 
ADVANTAGE OF LARGER REGIONS WHEN CONFIGURATION IS INCREASED 
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CONVENTIONAL MEMORY 


PROBLEMS 


® REAL MEMORY IS USED INEFFICIENTLY 


] WITHIN A REGION, PROGRAM COMPONENTS OR DATA AREAS NOT REFERENCED 
STILL OCCUPY REAL MEMORY 


f UNUSED SPACE BETWEEN REGIONS WASTES REAL MEMORY (FRAGMENTATION) 


@ SCHEMES FOR USING REAL MEMORY MORE EFFICIENTLY ARE COSTLY 
J CPU COST OF MOVING REGIONS TO REDUCE FRAGMENTATION 


J CPU AND I/0 COSTS “TO SWAP OUT ENTIRE REGIONS TO SHARE REAL 
MEMORY AMONG MORE USERS 


® NO PROTECTION OF DATA WITHIN A REGION 


J PROGRAMMING ERRORS CAN CAUSE UNWANTED WRITING INTO PROGRAM OR 
DATA AREAS 
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No 


c 


CONVENTIONAL MEMORY 


PROBLEMS 


OVERHEAD AND INCONVENIENCE OF LOADING AND LINKAGE EDITING 


NO SHARING OF PROGRAMS AND DATA BETWEEN REGIONS 


{ EACH REGION MUST CONTAIN A COPY OF SHARED DATA (INEFFICIENT USE 
OF MEMORY) 


f MODIFICATIONS TO SHARED DATA CANNOT EASILY BE REFLECTED IN ALL 
COPIES 


PHYSICAL INPUT/OUTPUT OPERATIONS ON DISK FILES OFTEN BECOME THE 
RESPONSIBILITY OF THE PROGRAMMER (REDUCING PRODUCTIVITY) 


To Be Reproduced 15-6 F8OA 


SINGLE VIRTUAL MEMORY 
STRUCTURE 


® A LARGE ADDRESS SPACE USED BY THE SYSTEM (EG, 4M WORDS) 


® THE ADDRESS SPACE IS LOGICALLY DIVIDED INTO REGIONS OF VARIOUS 
SIZES, AS IN CONVENTIONAL MEMORY 


® THE VIRTUAL MEMORY IS PHYSICALLY DIVIDED INTO PAGES HAVING A FIXED 
SIZE 


@® THE ADDRESS SPACE AND THE VIRTUAL MEMORY HAVE THE SAME SIZE 


® THE 1- DIMENSIONAL ADDRESS SPACE IS MAPPED DIRECTLY one THE PAGED, 
i-DIMENSIONAL VIRTUAL MEMORY 


® THE VIRTUAL MEMORY IS MAPPED BY A PAGING ALGORITHM ONTO A SMALLER 
(EG, 256K WORDS) REAL MEMORY 


® PROGRAMS MUST BE LOADED INTO THE VIRTUAL MEMORY AS IN CONVENTIONAL 
MEMORY SYSTEMS 


Not To Be Reproduced 1557 F8OA 


SINGLE VIRTUAL MEMORY 


CHARACTERISTICS 


® LINKAGE EDITING REQUIRED AS IN CONVENTIONAL MEMORY SYSTEMS 


® EXAMPLES: 


. IBM OS/VS~-1 OR OS/VS-2 RELEASE 1 


Not To Be Reproduced 15-6 F8O0A 


SINGLE VIRTUAL MEMORY 


SOLVED PROBLEMS 


@® THE SYSTEM'S ADDRESS SPACE IS MUCH LARGER THAN REAL MEMORY 


] THE SYSTEM CAN RUN MORE AND/OR LARGER USER REGIONS 


@ THE USER REGIONS CAN BE LARGER 


PROGRAMS CAN BE WRITTEN FOR A LARGE REGION TO TAKE ADVANTAGE OF 
ADDITIONAL MEMORY WHEN IT IS AVAILABLE 


® PROGRAMMER PRODUCTIVITY IMPROVES 
f PROGRAMMERS WORRY LESS ABOUT OPTIMIZING MEMORY USAGE 


) CONVERTING PROGRAMS TO USE LARGER MEMORY CONFIGURATIONS OFTEN 
UNNECESSARY - LESS COMPETITION 


® REAL MEMORY USED MORE EFFICIENTLY 
] FEWER UNREFERENCED AREAS OF ADDRESS SPACE OCCUPY REAL MEMORY 


] PAGING ALGORITHM SIMPLIFIES MEMORY MANAGEMENT SCHEMES 
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SINGLE VIRTUAL MEMORY 


PROBLEMS 
® MEMORY SWAPPING MAY STILL BE NECESSARY TO SHARE THE ADDRESS SPACE 


AMONG MANY USERS 


® USER REGIONS STILL TOO SMALL TO HANDLE EVERY APPLICATION. SOME 
MEMORY MANAGEMENT STILL REQUIRED 


@ NO PROTECTION OF DATA WITHIN A REGION 


® OVERHEAD AND INCONVENIENCE OF LOADING AND LINKAGE EDITING 


® NO SHARING OF DATA BETWEEN REGIONS 


& EXPLICIT DIsk 1/0 STILE REQUIRED ‘TO ACCESS FILES 


® THE ADVANTAGES OF SOLVING THE PROBLEMS ABOVE MAY BE OUTWEIGHED BY 
COSTS IN HARDWARE AND SOFTWARE OF THE PAGING OVERHEAD 


Not To Be Reproduced LO=L0 FBOA 


MULTIPLE VIRTUAL MEMORIES 


STRUCTURE 


@ THE SYSTEM USES MANY LARGE (4M WORD), iI-DIMENSIONAL ADDRESS SPACES, 
ONE PER USER REGION 


@ EACH ADDRESS SPACE CONTAINS THE SUPERVISOR PROGRAMS PLUS ONE LARGE 
USER REGION (DIVIDED INTO POOLS), PLUS PROGRAMS AND DATA SHARED 
AMONG ALL REGIONS : 


@® EACH ADDRESS SPACE IS MAPPED DIRECTLY ONTO ITS OWN, PAGED VIRTUAL 
MEMORY 


® EACH VIRTUAL MEMORY IS MAPPED BY A PAGING ALGORITHM ONTO THE 
SINGLE, SMALLER REAL MEMORY 


® PROGRAMS MUST BE LOADED INTO THE VIRTUAL MEMORY AS IN CONVENTIONAL 
MEMORY SYSTEMS 


® LINKAGE EDITING REQUIRED AS IN CONVENTIONAL MEMORY SYSTEMS 
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MULTIPLE VIRTUAL MEMORIES 


CHARACTERISTICS 


® EXAMPLES: 


| IBM OS/VS-2 RELEASE 2 (MVS) 


Not To Be Reproduced 15-12 


MULTIPLE VIRTUAL MEMORIES 


SOLVED PROBLEMS 


® THE LARGE USER REGIONS CAN HANDLE ALL BUT THE LARGEST PROGRAMS 
WITHOUT SPECIAL MEMORY MANAGEMENT. PROGRAMMER MUST STILL DIVIDE 
REGIONS INTO POOLS, HOWEVER, AND SOMETIMES PROVIDE POOL OVERFLOW 
MECHANISMS 


® MEMORY SWAPPING IS NOW UNNECESSARY. PREVIOUSLY SWAPPED REGIONS NOW 
OCCUPY THEIR OWN ADDRESS SPACES AND ARE PAGED IN AND OUT 


@® PROGRAMS AND DATA (USUALLY READ-ONLY) CAN BE SHARED BETWEEN REGIONS 
IN A LIMITED WAY BY OCCUPYING THE SAME POOL IN EVERY ADDRESS SPACE 


® NEWLY SOLVED PROBLEMS MAKE PAGING OVERHEAD MORE WORTHWHILE 
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MULTIPLE VIRTUAL MEMORIES 


PROBLEMS 


® NO PROTECTION OF DATA WITHIN THE MAJORITY OF A USER'S ADDRESS SPACE 


(REGION) 


® OVERHEAD AND INCONVENIENCE OF LOADING AND LINKAGE EDITING 


8 ENERAL SHARING OF READ-WRITE DATA STILL NOT POSSIBLE 


® EXPLICIT DISK 1/0 STILL REQUIRED TO ACCESS FILES 
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MULTICS VIRTUAL MEMORY 


STRUCTURE 


® THE SYSTEM USES MANY, VERY LARGE (EG, 256M WORDS), 2-DIMENSIONAL 
ADDRESS SPACES, ONE PER USER PROCESS (REGION) 


® EACH ADDRESS SPACE IS DIVIDED INTO SEGMENTS WHICH PERFORM THE SAME 
FUNCTION AS POOLS IN MULTIPLE VIRTUAL MEMORY SYSTEMS 


® SEGMENTS: 


HAVE VARYING SIZES 


ol 


ARE EXTEND 


t 


L 
ARE FILES IN THE MULTICS STORAGE SYSTEM 


ARE ACCESSED AS READ-WRITE, READ-ONLY, EXECUTABLE OR CALLABLE 


DATA, WITH ACCESS CONTROLLED BY AN ACL, RING BRACKETS AND AN AIM 


CLASSIFICATION 


ARE SHARED AMONG ADDRESS SPACES, WITH EACH ADDRESS SPACE HAVING 
ITS OWN PERMISSION TO ACCESS THE SEGMENT 
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MULTICS VIRTUAL MEMORY 


CHARACTERISTICS 


® EACH ADDRESS SPACE INTERSECTS IN VARYING DEGREES WITH EVERY OTHER 
ADDRESS SPACE 


® EACH ADDRESS SPACE IS MAPPED DIRECTLY ONTO ITS OWN PAGED, SEGMENTED 
. VIRTUAL MEMORY OF THE SAME SIZE 


@® EACH VIRTUAL MEMORY IS MAPPED BY A PAGING ALGORITHM ONTO THE 
SINGLE, SMALLER REAL MEMORY 


@ NO LOADING IS REQUIRED SINCE ALL ADDRESSES ARE INTERPRETED AS 
OFFSETS WITHIN SEGMENTS 


® NO LINKAGE EDITING IS REQUIRED SINCE ALL SYMBOLIC REFERENCES ARE 
RESOLVED AT RUN TIME IF AND WHEN THEY ARE ENCOUNTERED (DYNAMIC 
LINKING) 
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MULTICS VIRTUAL MEMORY 


SOLVED PROBLEMS 


® DATA WITHIN THE ADDRESS SPACE PROTECTED 


f READ OR READ-EXECUTE DATA STORED IN SEPARATE SEGMENTS WHICH ARE 
PROTECTED FROM MODIFICATION 


f PROGRAMMING ERRORS REFERENCING OUTSIDE ARRAY BOUNDS CANNOT 
REFERENCE DATA IN ANOTHER SEGMENT 


@® DATA CAN BE SHARED IN A GENERAL WAY BETWEEN ADDRESS SPACES 


] EACH SEGMENT (NOT A COPY OF THE SEGMENT) CAN APPEAR IN SEVERAL 
ADDRESS SPACES 


J DIFFERENT PROCESSES CAN HAVE DIFFERENT ACCESS TO THE SAME 
SEGMENT IN THEIR ADDRESS SPACE 


® OVERHEAD AND INCONVENIENCE OF LOADING (SOFTWARE) REPLACED BY AN 
ADDRESS FORMATION SCHEME (HARDWARE) 


] UNREFERENCED PROGRAMS (AND/OR PAGES OF PROGRAMS) DO NOT REQUIRE 
MAIN MEMORY SPACE 
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MULTICS VIRTUAL MEMORY 


SOLVED PROBLEMS 


1 PROGRAMS NEVER REQUIRE PREPARATORY ADDRESS MODIFICATION 


® EXPLICIT 1/0 IS NOT REQUIRED TO ACCESS FILES (SEGMENTS) 


- ff SEGMENTS CAN BE ACCESSED BY MAKING THEM KNOWN TO THE ADDRESS 
SPACE AND REFERENCING THE SEGMENT 


J THIS IS CALLED VIRTUAL FILE I/O 


® OVERHEAD AND INCONVENIENCE OF LINKAGE EDITING REPLACED BY DYNAMIC 
LINKING 


. UNREFERENCED PROGRAMS DO NOT REQUIRE LINKING 


® ADVANTAGES OF VERY LARGE ADDRESS SPACE, SHARED FILES, DATA 
PROTECTION, AND VIRTUAL I/O DEFINITELY OUTWEIGH THE COSTS OF PAGING 
AND SEGMENTATION OVERHEAD 
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MULTICS VIRTUAL MEMORY 


PROBLEMS 


e MULTICS FILE I/O IS OFTEN LESS EFFICIENT THEN SPECIAL CASED METHODS 
BASED ON KNOWN ACCESS PATTERNS 


® THE SYSTEM'S SEGMENT SIZE DOES NOT GENERALIZE UPWARD TO HANDLE VERY 
LARGE DATA BASES. ALTERNATE (KLUDGY) METHODS MUST BE USED (SUCH AS 
MSF'S) 


® THE OVERHEAD TO TOUCH A PAGE OF ONE HUNDRED DIFFERENT SEGMENTS IS 
CONSIDERABLY MORE THAN THE OVERHEAD TO TOUCH ONE HUNDRED PAGES OF. 
THE SAME SEGMENT. Cia: SPARSE AND INFREQUENT ACCESSING IS 
EXPENSIVE) 


® LACK OF EXPLICIT I/0 CONTROL MAKES OVERALL SYSTEM RELIABILITY 
SUFFER SINCE FULL RECOVERY FROM A SYSTEM CRASH REQUIRES THE 
SUCCESSFUL FLUSHING OF ALL PAGES FROM MAIN MEMORY 


f hes _sforce_write MAY BE USED BY THOSE APPLICATIONS REQUIRING 
SUCH RELIABILITY 
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add_type.incl.plii segment in: >Idd>include contents modified: 


entry modified: 03/10/82 0836.5 


/* BEGIN INCLUDE FILE add_type.incl.plt +/ 
/* 02/26/75 by Bernard S. Greenberg */ 


/* This file provides a structure for checking 
PTW/CME address type fields in PL/I */ 


° 


dcl 1 add_type unaligned static internal, 


2 core bit (4) intt ("1000"b), /* in core- S/B only in PTW +*/ 
2 disk bit (4) init ("0100"b), /* Disk address +*/ 

2 pd bit (4) tnit ("O010"b), /* Paging Device */ 

2 reserved bit (4) init ("OO001"b), /* Reserved */ 

2 non_nullt bit (4) init Cetttirb); /* Not null address +/ 


del 1 badd_type unaligned based, 
2 (core, disk, pd, reserved) bit (1) unaligned; 


include — 


FBOA 


/* END INCLUDE FILE add_type.incl.pli */ 


09/16/77 


0925.5 


<*, hard.source—~—~—~—”—~—C—<“CSCSO™””™CT. ade type. inet poo!!!) 
ot to be reproduced 


qe { 


aim_template.inc!.pii segment in: >1dd>include contents modified: 12/20/78 1614.1 


/* 


/* 
/* 


/* 


dc} 


/* 


entry modified: 03/10/82 0836.6 


BEGIN INCLUDE FILE aim_template.inc!.pii */ 


Created 740722 by PG */ 
Modified 06/28/78 by C. D. Tavares to add rcp privilege */ 


This structure defines the components of both an access 
class and an access authorization as interpreted by the 
Access Isolation Mechanism. */ 


1 aim_template aligned based, /* authorization/access class template */ 
2 categories bit (36), /* access categories */ 
2 level fixed bin (17) unal tgned, /* sensitivity level */ 
2 privileges unaligned, /* special access privileges ({n authorization only) */ 
(3 ipc, /* interprocess communication privitege */ 
3 dir, /* directory privilege */ 
3 seg, /* segment privilege */ 
3 soos, /* securtty out-of-service privilege */ 
3 ringi, /* ring 1 access privilege */ 
3 rep) bit (4), /* RCP resource access privilege */ 
3 pad bit (12); 


END INCLUDE FILE aim_template.incl.pli */ 


include.*+*, hard.source aim_template. incl.pit Page 2 
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apte.incl.pli 


/* BEGIN INCLUDE FILE apte.inc!.plt +/ 


dcl aptep pointer; 


dc! 1 apte based (aptep) aligned, 
2 thread unaligned, 
3 fp bit (18), 
3 bp bit (18), 
2 flags unaligned, 
mbz bit (1), 
wakeup_waiting bit (14). 
stop_pending bit (1), 
pre_empted bit (1), 
hproc bit (1), 
loaded bit (1), 
eligible bit (1), 
idie bit (1), 
interaction bit (1), 
pre_empt_pending bit (1), 
default_procs_required bit (1), 
realtime burst bit (1), 
always_loaded bit (1), 
dbr_loaded bit (1), 
being_ltoaded bit (1), 
shared_stack_O bit (1 
page_wait_flag bit (1 
firstsw bit (1), 
state bit (18), 
- 2 page_faults fixed bin (35), 
2 processid bit (36), 


). 
), 


QWWWNAWNUNHWUYWHOWDHNYWWW Ww 


2 te fixed bin (35), 
2 ts fixed bin (35), 
2 ti fixed bin (35), 
2 timax fixed bin (35), 


[+ * + # & ‘* * af 


2 ipc_pointers unaligned, 
3 event_thread bit (18), 
3 pad3 bit (18), 
2 ips_message bit (36), 
2 asteps unaligned, 
3 pds bit (18), 
3 dseg bit (18), 
3 prds bit (18), 
Savex7 bit (18) unaltgned, 
term_processid bit (36), 


Lm) 


include °, nhard.source 
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segment 


entry modif ted: 


~~ apte.incel. pit. 


in: >1dd> include contents modified: 


12/15/82 1433.5 


12/15/82 


APT entry declaration for an active (known) process */ 


List thread +/ 

Forward pointer */ 

Backward pointer +*/ 

Flags and miscellaneous +/ 

This bit must be zero (sentinel bit) */ 
ON {f process has received wakeup */ 

ON if process has received stop connect */ 


ON if process {s being pre-empted by get_processor +/ 


ON if process {ts hardcore process */ 

ON if process is eligible */ 

this is an idle process */ 

ON if process has interacted recently */ 


ON if process has received pre-empt connect */ 
apte.procs_ required is system default */ 


ON if next eligibility ts realtime +/ 
ON if process is not to be unloaded +/ 
ON if DBR is toaded on some CPU */ 

ON if somebody loading this process */ 
ON if a shared stack_O is assigned */ 
flag ON ff waiting for page */ 

OFF until process is intialized +*/ 
execution state */ 

total page faults for the process */ 
bit 0-17: offset of ATPE «/ 

bit 18-35: sequential number */ 
virtual time since eligibftlity award +/ 
virtual time since scheduling +*/ 
virtual time since tnteraction +*/ 
maxtmum value allowed for apte.tt */ 


relative pointer to ITT list +/ 


IPS signals pending +/ 

relative ASTE pointers +¢/ 

PDS (per-process) +/ 

DSEG (per-process) +/ 

PRDS (per-processor) +*/ 

x7 at call to getwork (return potnt tn pxss) 
process to send wakeup at temination +«/ 


+/ 


1432.3 


required per-process pages are {n memory and wired */ 


te 


3 


2 lock_id bit (36), /* File System unqieu ID associated with process */ 
2 time_used_ clock fixed bin (71), /* Total CPU time when process last lost CPU »¥/ 


fe ee we ee me we a 


2 wait_event bit (36) aligned, /* Event ID process awaiting */ 
2 wet_index bit (18) unaligned, /* rel offset of WCTE */ 
2 flags2 unaligned, 
3 priority_scheduling bit (1), /* ON if guaranteed eligibility */ 
3 special_wakeups bit (6), /* Special wakeup channels */ 
3 pad7 bit (7), 
3 batch bit (4), /* ON if absentee */ 
3 pr_tag bit (3), /* CPU tag running or last run */ 
2 state _change_time fixed bin (71), /* Time apte.state last changed */ 
2 alarm_event fixed bin (71), /* wakeup event for alarm clock manager */ 
2 alarm_time_thread bit (18) unaligned, /* thread of processes with pending alarms */ 
2 alarm_time bit (54) unaligned, /* wakeup time for atarm */ 


fae ew & ow af 


2 term channel. fixed bin (71), /* wakeup event for account overflow */ 

2 ws_size fixed bin, /* working set estimate for the process */ 

2 temax fixed bin (35), /* maximum eligibility slice (vcpu) +/ 

2 deadline fixed bin (71), /* time of next run */ 

2 lock bit (18) unaligned, /* O => APTE locked, unlocked => return point of last unlock */ 

2 unusable bit (18) unaligned, /* locking routines destroy */ 

2 cpu_monitor fixed bin (35), /* if not O, send wakeup to term_processid when virtual cpu 
/* reaches this (units = 1/1024 sec) */ 

2 paging_measure fixed bin (71), _ /* cumulative memory units */ 

2 access authorization bit (72), /* authorization of thts process */ 

2 dbr fixed bin (71), /* DBR value (constant since DSEG entry-held) */ 

2 virtual _cpu_time fixed bin (71), /* cumulative virtual CPU time for the process */ 

2 ittes sent fixed bin (18), /* Unprocessed ITTs sent by this process */ 

2 ittes got fixed bin (18), /* Unprocessed ITTs received by this process */ 


/* Cells used to drive and instrument finite-state model for response time 
measurement. Maintained by meter_response_time */ 


2 current_response_state fixed bin (17) unaligned, /* Process state in modle */ 

2 padt8 bit (18) unaligned, 

2 number processing fixed bin (35), /* Number interactions */ 

2 last_response_state_time fixed bin (71), /* Clock time’ at last response state change */ 
2 total processing time fixed bin (71), /* Total interaction processing time */ 


[+ * te ee af 

2 begin_interactton_vcpu ftxed bin (71), /* Virtual cpu at beginning of tast interaction */ 
/+* End of cells for finite-state model */ 

2 saved_temax fixed bin (35), /* temax at eligibility award +/ 


2 procs_required bit (8) unaligned, /* bit mask of CPUs this process can run */ 
2 apad (12) fixed bin (35); 


include.+*, hard. source apte.tincl.plt Page 4 
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/* END INCLUDE FILE ... apte.incl.pit */ 


include _ 


FROA 


~ hard. source 


t to be reproduced 


apte.tncl.pit 


aste.incl.pid 


/* 


BEGIN INCLUDE FILE ...aste. 


segment 


in: >Idd>tnclude contents modified: 11/16/82 1454.6 


entry modified: 11/16/82 1456.6 


incl.pli ... */ 


/* Template for an AST entry. Length = 12 words. */ 


/* Words O to 7, 


and ti are read by PC; 


Words 8, 9 and 10 are modified by PC; 
dct astep ptr; 
dc! 1 aste based (astep) aligned, 


~ 


(2 fp bit (18), 


2 


2 
2 


NNN 


DOD NAPNHNANADNUNUNAN NA NNN NANA 


bp bit (18), 


infl bit (18), 
infp bit (18), 


strp bit (18), 
par_astep bit (18), 


uid bit (36), 


msi bit (9). 
pvtx fixed bin (8), 
vtocx fixed bin (17), 


usedf bit ( 
init bit (14 
gtus bit (1 
gtms bit (1 
he bit (1), 
hc_sdw bit (1), 
any_access_on bit (1), 
write _access_on bit (1), 
inhibit_cache bit (1), 
explicit _deact_ok bit (1), 
deact_error bit (1), 
hc_part bit (1), 
fm_damaged bit (1), 

pad! bit (3), 

dius bit (1), 

nid bit (1), 

dmpr_pad bit (1), 

ens bit (1), 

nqsw bit (1), 

dirsw bit (1), 

master_dir bit (1), 
volmap_seg bit (1), 

tqsw (0:4) bit (1) 


include.+*+#, hard.source 
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aste.incl. 


pli 


they are read and modified by SC. 
they should never be modified without locking the PC lock */ 


forward used list rel pointer */ 
backward used list rel pointer */ 


ptr to NEXT in list of ASTE’s of my brothers */ 
ptr to FIRST in Vist of ASTE’s of my children +/ 


rel pointer to process trailer */ 
rel pointer to parent aste */ 


segment unique id */ 


maximum sagment length in 1024 word units */ 
physical volume table index +/ 
vtoc entry tndex */ 


ast entry is being used if non-zero */ 

used bit - insure 1 lap */ 

global transparent usage switch */ 

global transparent modified switch */ 

hard core segment */ 

aste with sdw for hardcore seg if non-zero */ 
any sdw allows access, unless write access_on */ 
any sdw allows write access +#/ 

flaqg not to reset above bits */ 

set if user can deactivate seg */ 

set if error occurred while deactivating */ 

set if pages are in a hardcore partition */ 

set if filemap checksum was ever bad */ 

ooooo +/ 

dumper in use switch «/ : 

if on prevents addtion to incremental dump map */ 


entry hold switch +/ 

no quota switch - no checking for pages of this seg */ 
directory switch +*/ 

master dir - a root for the log volume */ 

volmap_seg for some volume */ 

terminal quota switch - (0) for non dir pages +*/ 


Page 
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dc! 


dc} 


dc} 


/* 


Le] 


RO AS 939 8 1 A DA BR A PB 


09 99 1 AD DD 


NOM RS oe 


asta (0 : 


pad_ic bit (10), 
dtu bit (36), 


dtm bit (36), 


quota (0:1) fixed bin (18) unsigned, 
used (0:1) fixed bin (18) unsigned, 


cst bit (9), 
fmchanged bit (1), 
fms bit (1) 
npfs bit (1 
gtpd bit (1 
dnzp bit (1 
per_process 
ddnp bit (1 
pad2 bit (2), 
records bit (9), 


), 
). 
), 
bit (1). 
y 


ht_fp bit (18), 

fmchanged! bit (1), 
damaged bit (1), 

pack_ovfl bit (1), . 
synchronized bit (1), 

pad3 bit (6), 

ptsi bit’(2), 

marker bit (6)) unaligned: 


aste_part aligned based (astep), 


one bit (36) unaligned, 
two bit (36*11 - 8) unaligned, 
three bit (8) unaligned; 


seg_aste based (astep) aligned, 
padi bit (8*36), 

usage fixed bin (35), 

pad2 bit (3*36); 


END INCLUDE FILE 


include *, hard. source 


“80A 


ot to be reproduced 


aste.inc!.pli */ 


8000) bit (36+12 /* sst-> sst.astsize */) based 


aste.incl.plit 


Used to be aste.ic */ 
date and time segment last used */ 


date and time segment last modified */ 


sec storage quota - (0) for non dir pages */ 
sec storage used - (0) for non dir pages */ 


current segment length in 1024 words units */ 
turned on by page tf file map changed */ 

file modified switch */ 

no page fault switch */ 

global transparent paging device switch */ 
don’t null out {ff zero page switch */ 

use master quota for this entry */ 

don’t deposit nulled pages */ 


number of records used by the seg tn sec storage */ 
number of pages in core */ 


hash table forward rel pointer */ 

value of "fmchanged" saved by pc$get_file_map */ 
PC declared segment unusable */— 

page fault on seg would cause pack overflow */ 
Data Management synchronized segment */ 
ooo0000000 */ 

page table size index */ 

marker to indicate last word of ASTE */ 


aligned; 
fp and bp */ 


part that has to be zeroed when ASTE is freed */ 
pts! and marker */ 


Over lay because quota is only for dirs */ 


page fault count: overlays quota */ 


r-qge 


. bos_dump.incl.pii 


/* BEGIN INCLUDE FILE bos_ dump. inci.pl1 

/* Modified 1 September 1976 *«/ 

/* Modtfied 41/11/80 by J. A. 

/* Modif ied 
15 bits +/ 


/* Modified 02/23/81, W. Olin Sibert, 


dumpptr ptr; 


dump based (dumpptr) aligned, 
2 dump_header aligned jiike Gump_header , 


2 segs (1008), 
3 segno bit (18) unal, 
3 length bit (18) unal, 


2 amptwregs (O : 63) bit (36), 
2 amptwptrs (0 63) bit (36), 
2 amsdwregs (0 : 63) bit (72), 
2 amsdwptrs (O : 63) bit (36), 


2 ouhist (0 63) bit (72), 
2 cuhist (0 63) bit (72), 
2 duhist (0 63) bit (72), 
2 auhist (0 : 63) bit (72), 
2 prs (0 7) ptr, 


2 regs aligned jike dump_registers, 


low_order_port bit (3), 
pad4 bit (36), 

mctime fixed bin (52), 
pad5 (0 3) bit (36), 


RO ND RO NO 


2 misc_registers like dump_misc_registers, 


2 ptrien (0 7) bit (36), 
2 coreblocks (0 7), 
3 num_first bit (18) unal, 
3 num_biocks bit (18) unal, 
2 pad7 (112) fixed bin; 


dct i dump_header aligned based, 
2 words dumped fixed bin (35), 
2 valid bit (1), 


include.+*, hard. source 


FBOA - Not ta be reproduced 


segment 


entry modified: 


+/ 


Bush for the DPS8/70M CPU */ 
6/12/81 by Rich Coppola to extend the dps8 extended fault reg to 


/* 
/* 


/* 


bos dump. incl.plt 


>Idd> include contents modified: 09/08/81 1426.4 


03/10/82 0837.0 


in: 


to describe old and new FDUMP styles +*/ 


pointer to following structure */ 


header of dump by fdump */ 


segment array */ 
segment number */ 
length of segment in sector sized blocks «/ 

page table word regs */ 

page table word pointers */ 
segment descriptor word registers */ 
segment descriptor word pointers */ 


assoc. 
assoc. 
assoc. 
assoc. 


mem. 
nem. 
mem. 
mem. 
operations unit history registers */ 
control unit history registers */ 
decimal unit history registers */ 
appending unit history registers */ 
pointer registers */ 

assorted machine registers */ 

from which clock is read */ 


time conditions were taken */ 


Assorted registers & processor data */ 


pointers and lengths for EIS */ 


first addr itn coreblock +/ 
number of blocks used *«/ 


Standard header for FDUMP */ 
total words in dump +/ 
= 1 {f there is a 6180 dump to be had +/ 


~ Page _ 


8 


time fixed bin (71), 
erfno fixed bin (18), 
num_segs fixed bin, 
valid_355 bit (1), 
dumped_355s bit (4), 
time_355 fixed bin (71), 
version fixed bin, 

padO (5) fixed bin; 


A NM A 


dump_registers aligned based, 
x (0; 7) bit (18), 

a bit (36), 

q bit (36), 

e bit (8), 

pad2 bit (28), 

t bit (27), 

pad3 bit (6), 

ralr bit (3)) unaligned; 


dct 


RR RP DAD fo 


dc} dump_misc_registers aligned based, 
scu (0 : 7) bit (36), 

mem (O : 7) bit (72), 

dbr bit (72), 

intrpts bit (36), 

bar bit (36), 

modereg bit (36), . 
cmodereg bit (36), 

faultreg bit (36), 

ext_fault_reg bit (15) unaligned, 
pad6 bit (21) unaligned; 


SNM MN DDD AN 


dc! 1 vt_dump aligned based (dumpptr), 
2 dump_header aligned tike dump_header, 


2 segs (688), 
3 segno bit (18) unal, 
3 length bit (18) unal, 


15) bit (72), 
: 15) bit (36), 
(O : 15) bit (36), 
(O : 15) bit (36), 
15) bit (36), 


(0: 
(0 


amsdwregs 
amsdwptrs 
amp twregs 
amptwptrs 
padt (0 


NNN ND 


ouhist (O 
cuhist 
auhist 
duhist (0 : 


15) bit (72), 
18) bit (72), 
15) bit (72), 
1S) bit (72), 


BOHN 


Ls 


prs (0 7) ptr, 


2 regs aligned ltke dump_registers, 


include *, hard.source 


‘A ot to be reproduced 


bos_dump. 


inclt.r 


time of dump */ 

Error Report Form Number */ 

number of segments dumped */ 

= { if there is a dn355 dump to be had *«/ 
indicates which 355s were dumped */ 

time of 355 dump +/ 

currently 2 */ 

padO to 16 words +*/ 


Standard (SREG) arrangement of registers in dump */ 
index registers */ 

the a register +*/ 

the q register */ 

the e register */ 

pad */ 

timer register */ 

pad */ 

ring alarm register +/ 


from store control untt instr. */ 
memory controller masks every 64 K */ 
descriptor segment base register */ 
interrupts */ 

base address eagierer +/ 

mode register */ 

cache mode register -*/ 

fault register */ 

DPSS extended fault register */ 


Old version of FOUMP (pre March, 1981) */ 


segment array */ 
segment number */ 


length of segment tn sector sized blocks */ 


assoc. mem. segment descriptor word registers */ 
assoc. mem. segment descriptor word potnters */ 
assoc. mem. page table word regs */ 

assoc. mem. page table word pointers +*/ 
operations unit history registers */ 


contro! unit history registers */ 
appending unit history registers */ 
decimal unit history registers */ 
pointer registers *«/ 


assorted machine registers */ 


ge 


2 mctime fixed bin (52), /* time conditions were taken +/ 
2 pad4 (O : 5) bit (36), , 
2 misc registers aligned like dump_misc_ registers, /* Assorted registers */ 
2 padS bit (36), 
2 ptrien (0 : 7) bit (36), /* pointers and lengths for EIS +*/ 
2 pad6 (15) bit (36), 
2 low_order_port bit (3), /+ from which clock was read +/ 
2 coreblocks (0 : 7), 
3 num_first bit (48) unal, /¢ first addr itn coreblock */ 


3 num_blocks bit (18) unal; : /* number of blocks used +/ 


dc} OUMP_VERSION_1 fixed bin internal static options (constant) init (1); 
dci DUMP_VERSION_2 fixed bin internal static options (constant) init (2); 


/* END INCLUDE FILE ... bos _dump.incl.plt ... */ 


include.**, hard.source bos dump. incl.p)1 “Page ‘10 


FS8OA - Not to be reproduced 


cmp.incl.ptift 


cn ne snr eR SRA An pe A ee NN A I 


/* BEGIN INCLUDE FILE cmp.incl.pti 
/* Note: This include file has an ALM counterpart NOT made with cif (for historical reasons). Keep itt up to date */ 


dc! 


dc} 


dc} 


dc} 


ONO NYY DD A SP ON = 


OND 


cmep ptr; 


cne based (cmep) aligned, 
fp bit (18) unaligned, 
bp bit (18) unaligned, 


devadd bit (22) unaligned, 
padS bit (1) unaligned, 
synch_held bit (1) unaligned, 
fo bit (4) unaligned, 

pad2 bit (1) unaligned, 

er bit (1) unaligned, 
removing bit (1) unaltgned, 
abs_w bit (1) unaligned, 
abs_usable bit (1) unaligned, 
notify_requested bit (1) unaligned, 
pad3 bit (1) unaligned, 
phm_hedge bit (1) unaligned, 
contr bit (3) unaligned, 


ptwp bit (18) unaligned, 
astep bit (18) unaligned, 
pin_counter fixed bin (17) unaligned, 
synch_page_entryp bit (18) unaligned; 


cma (0: 1) based aligned like cme; 


mcme based (cmep) aligned, 
pad bit (36) unaligned, 
record_no bit (18) unaltgned, 
add_type bit (4) unaligned, 
flags bit (14) unal, 

padi bit (18) unal; 


/* END INCLUDE FILE cmp.tncl.plt */ 


include “*, hard.source 


FBOA 


yt to be reproduced 


segment 


in: >Idd>include 


entry modified: 11/19/82 1604.3 


--- October 1982 */ 


/* 


a ae ER A 


cmp.incl.plf 


pointer to core map entry */ 


core map entry */ 
forward pointer to next entry */ 
backward pointer to previous entry */ 


‘device address of page in the core block */ 


Page of synchronized seg held in memory */ 
input/output indicator 1=output, O=tnput */ 


indicates error in previous I10 activity */ 

core is being removed :by reconfiguration */ 
absolute address must not be changed for page */ 
page may be assigned with fixed absolute address +/ 


notify requested on 1/0 completion */ 


on => pe$flush_core ought write. */ 


controlter in whitch core block is located */ 


pointer to page table word for the page */ 


relative AST entry pointer of page */ 
number of times to skip eviction */ 
relp to synch.page entry */ 


‘ Core map array */ 


‘ core map entry for extracting DID */ 


record number of device */ 
see add_type.incl.pl1 */ 


- contents modified: 


1602.1 


dbm. inc).pit 


/* BEGIN INCLUDE FILE 


dc} 
dc} 


dc! 1 
2 


/+ END INCLUDE FILE 


dbm.inc!.pli 


dbm_seg$ ext; 
dbmp ptr; 


dbm based (dbmp) aligned, 
lock_data, 

3 lock bit (36), 

3 event bit (36), 

3 notify bit (1), 
control, 

3 tnit bit (4) unal, 

3 padi bit (35) unal, 
stats, 

3 sets fixed bin unal, 

3 resets fixed bin unal, 
3 allocs fixed bin unal, 
3 frees fixed bin unal, 
pad2 (2) bit (36), 

area area (255+1024 -8); 


dbm.incl.pli */ 


segment in: 
entry modified: 


ry 


Feb 1976 +«/ 


> Idd> include 


05/20/82 


contents modified: 
1047.5 


include. 44, 


FBOA 


hard.source 


- Not to be reproduced 


dbm. inc).pli 


05/20/82 


1037.5 
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cnsemmmpenomteeaimene diem eemaghemne te ern en a eee 


dir_acl.inci.pli segment tn: >Idd>inctude contents modified: 02/24/76 
entry modified: 03/10/82 0836.4 


a ET ATL 8 er SS St Rh er Sy ey tre RE eh tn 


/* BEGIN INCLUDE FILE ... dir_acl.incl.pli ... last modified Nov 1975 for nss */ 
/* Temptate for an ACL entry. Length = 8 words */ 
dct aclep ptr; 


acl_entry based (aclep) aligned, /* length is 8 words +*/ 


dct 4 

2 frp bit( 18) unaligned, /* rel ptr to next entry */ 

2 orp bit( 18) unaligned, /* rel ptr to previous entry */ 

2 type bit (18) unaligned, /* type = dir acl */ 

2 size fixed bin (17) unaligned, /* size of acl entry +*/ 

2 name unaligned, /* user name associated with this ACL entry */ 
3 pers_rp bit(18) unaligned, /* name of user */ 
3 proj_rp bit(18) unaligned, /* project of user */ 
3 tag char(1) unaligned, /* tag of user */ 

2 mode bit (3) unaligned, /* mode for userid */ 

2 pad24 bit(24) unaltgned, 

2 ex_mode bit(36), /* extended access modes */ 

2 checksum bit (36), _ /* checksum from acl_entry.name */ 

2 owner bit (36); : /* uid of owning entry +*/ 


/* Template for a person or project name on ACL. Length = 14 words. */ 


dc! 1 access_name aligned based, /* person or project name */ 
2 frp bit( 18) unaligned, /* rel ptr to next name structure */ 
2 brp bit(18) unaltgned, /* rel ptr to prev name structure */ 
2 type bit (18) unaligned, /* type = access name */ 
2 size fixed bin (17) unaligned, /* size of access name */ 
2 salv_flag fixed bin(17) unaligned, /* used by salvager to check for ascii names */ 
2 usage fixed bin( 17) unaligned, /* number of ACL entries that refer to this name */ 
2 padi bit (36), 
2 name char(32) aligned, /* person or project name itself */ 
2 checksum bit (36), /* checksum from salv_flag */ 
2 owner bit (36); : /* uid of containing directory */ 
/* END INCLUDE FILE ... dir_acl.inct.pli */ 


include -, hard. source dir_acl.incl.p! 


“ A 5st to be reproduced 


1923.4 


‘e 


dir_ 


/* 
del 


dc 


/* 


allocation_area.inci.pli 


BEGIN INCLUDE FILE 
areap ptr; 


area based (areap) aligned, 
nsizes fixed bin (18), 

tu fixed bin (18), 

Iw fixed bin (18), 

array (100) aligned, 

3 fptr bit (18) unaligned, 

3 size Fixed bin (17) unaligned; 


RO RMN 


END INCLUDE FILE 


include.**, hard.source 


FBOA 


- Not to be reproduced 


segment in: 


dir_allocation_area. inci.p1it 


>1dd> include 
03/10/82 0836.6 


contents modified: 09/22/76 


entry modified: 


1439.9 


last, modified December 1973 +*/ 


/* Number of types. +/ 

/* Next available word in area. +/ 
/+ Last usable word. +*/ 

/* Array of types. */ 

/* Free pointer for this size. */ 
/* Size. +*/ 


dir_allocation_area.inc!.pli */ 


dir_allocation area. incl.pi1 


“Page 


dir_entry.incl.plii segment : in: >dd>include contents modified: 04/26/76 
entry modified: 03/10/82 0836.5 


/* BEGIN INCLUDE FILE ... dir_entry.tncl.pl1 ...last modified August 1974 for nss */ 


/* Template for an entry. Length = 38 words */ 
dc) ep ptr; 


dc! 1 entry based (ep) aligned, 


(2 efrp bit (18), /* forward rel ptr to next entry */ 
2 eobrp bit (18)). unaligned, /* backward rel ptr to previous entry */ 
2 type bit (18) unaltgned, /* type of object = dir entry */ 
2 size fixed bin (17) unaligned, /* size of dir entry */ 
2 uid bit (36), /* unique id of entry */ 
2 dtem bit (36), /* date-time entry modified */ 
(2 bs bit (14), /* branch switch = 4 if branch */ 
2 padoO bit (17), 
2 nnames fixed bin (17), /* number of names for this entry */ 
2 name_frp bit (18), /* rel pointer to start of name list */ 
2 name_brp bit (18), /* rel pointer to end of name list */ 
2 author, /* user who created branch */ 
3 pers_rp bit (18), /* name of user who created branch */ 
3 proj_rp bit (18), /* project of user who created branch */ 
3 tag char (1), /* tag of user who created branch */ 
3 padi char (3), 
2 primary_name bit (504), /* first name on name list */ 
2 dtd bit (36), /* date time dumped */ 


2 pad2 bit (36), 


/* the deciarations below are for branch only */ 


2 pvid bit (36), /* physical volume id */ 

2 vtocx fixed bin (17), /* vtoc entry index */ 

2 pad3 bit (18), 

2 dirsw bit (1), 7* = 4 1f this is a directory branch */ 
include *, hard. source dir_entry.inci.- “4 


FOA pt to be reproduced 


1720.0 


/* 


include. +*, 


FSOA 


PON A ND 8 8 PO BN PD fo fe 


2 


oosw bit (1), 

per_process_sw bit (1), 

copysw bit (4), 

safety_sw bit (14), 

multiple class bit (1), 

audit flag bit (1), 
security_oosw bit (1), 
entrypt_sw bit (1), 

master_dir bit (1), 

tpd bit (14), 

pad4 bit (41), 
entrypt_bound bit (14)) unaligned, 


access class bit (72) aligned, 


(2 ring_brackets (3) bit (3), 


2 
2 


2 
2 


2 


ex_ring brackets (3) bit (3), 
acle_ count fixed bin (17), 


acl frp bit (18), 
ac! _ brp bit (18), 


bc_author, 

3 pers_rp bit (18), 

3 proj_rp bit (18), 

3 tag char (1), 

3 padS bit (2), 

bc fixed bin (24)) unaligned, 
sons_Ivid bit (36), 

pad6 bit (36), 

checksum bit (36), 

owner bit (36); 


END INCLUDE FILE dir_entry.incl.pli 


hard.source 


- Not to be reproduced 


/* 
/* 
+/ 


dir_entry.incl. ptt 


security attributes 


out of service switch on = 1 +#/ 

indicates segment is per process */ 

= 1 make copy of segment whenever initiated */ 
if’ 1 then entry cannot be deleted */ 

segment has multiple security classes */ 
segment must be audited for security */ 
security out of service switch */ 


1 if call limiter is to be enabled */ 

TRUE for master directory +/ 

TRUE if this segment is never to go on the PD */ 
cal) limiter +*/ 


level and category +/ 


ring brackets on segment +/ 

extended ring brackets +/ 

number of iantries on ACL +*/ 
*/ 


rel ptr to start of ACL 
rel ptr to end of ACL */ 


user who tast set the bit count */ 
name of user who set the bit count */ 
project of user who set the bit count */ 


tag of user who set the bit count */ 


bit count for segs, msf indicator for dirs */ 


. logical volume id for immediat inf non dir seg */ 


checksum from dtd */ 


uid of containing directory */ 


page = 


16 


dir_header.incl!.plit segment in: >Idd>include contents modifted: 05/12/82 1246.4 
; entry modified: 05/12/82 1254.5 


/* BEGIN INCLUDE FILE ... dir_header.incl.pli */ 

/* Modified 8/74 for NSS */ 

/* Modified 8/76 to add verston number and hash table rel pointer for variable hash table sizes */ 
/* Modified 3/82 BIM for change pclock */ 

/* format: styte3 */ 


/* Template for the directory header. Length = 64 words. */ 
dc! dp ptr; 


dc! 1 dir based (dp) aligned, 


2 modify bit (36), /* Process IO of tast modifier */ 
2 type bit (8) unaligned, /* type of object = dir header +*/ 
2 size fixed bin (17) unaligned, /* size of header in words */ 
2 dtc (3), /* date-tfime checked by salvager array */ 
3 date bit (36), . /* the date */ 
3 error bit (36), /* what errors were discovered */ 
2 uid bit (36). /* uid of the directory - copied from branch */ 
2 pvid bit (36), /* phys vol id of the dir - copied from branch *«/ 
2 sons_Ivid bit (36), /* log vol td for tnf non dtr seg - copied from branch */ 
2 access_class bit (72), /* security attributes of dir - copied from branch */ 
(2 vtocx fixed bin (17), , - {* vtoc entry index of the dir - copied from branch */ 
2 verston_number fixed bin (17),°: /* version number of header +*/ 
2 entryfrp bit (18), /* rel ptr to beginning of entry Vist */ 
2 pad2 bit (18), 
2 entrybrp bit (18), /* rel ptr to end of entry list */ 
2 pad3 bit (18), 
2 pers_frp bit (18), /* rel ptr to start of person name list */ 
2 proj_frp bit (18), /* rel ptr to start of project name list */ 
2 pers_brp bit (18), /* rel ptr to end of person name Vist */ 
2 proj_brp bit (18), /* rel ptr to end of project name list */ 
2 seg count fixed bin (17), /* number of non-directory branches */ 
2 dir_count fixed bin (17), /* number of directory branches */ 
2 Icount fixed bin (17), _/* number of links */ 
2 acle_total fixed bin (17), /* total number of ACL entries in directory */ 
2 arearp bit (18), /* relative pointer to beginning of allocation area */ 


{nclude +, hard.source dir_header.fncel ‘1 r +e 17 


“OA lot to be reproduced 


RS BS AD PO PO 


RO RO RO ND PO 


per_process_sw bit (1), 
master _dir bit (1), 
force _rpv bit (1), 
rehashing bit (14), 

pad4 bit (14), 


iacl_ count (0:7), 
3 seg fixed bin (17), 
3 dir fixed bin (17), 


facl (0:7), 
3 seg frp bit (18), 
3 seg brp bit (18), 


3 dir_frp bit (18), 
3 dir_brp bit (18), 


htsize fixed bin (17), 
hash_table rp bit (18), 


htused fixed bin (17), 
padG fixed bin (17), 


tree depth fixed bin (17), 


pad7 bit (18)) unaligned, 


dts bit (36), 


master_dir_uid bit (36), 


change _pclock fixed bin (35), 


pads (11) bit (36), 
checksum bit (36), 
owner bit (36); 


indicates dir contains per process segments */ 


TRUE if this is a master dir */ 
TRUE if segs must be on RPV +*/ 
TRUE if hash table is being constructed +*/ 


number of initial acl entries for segs */ 
number of initial acl entries for dir */ 


pointer to initial ACLS for each ring */ 
rel ptr to start of initial ACL for segs */ 
rel ptr to end of initial ACL for segs */ 


rel ptr to start of initial for dirs */ 
rel ptr to end of initial ACL for dirs */ 


size of hash table */ 
rel ptr to start of hash table */ 


no. of used places in hash table */ 
number of jievels from root of this dir */ 


date-time directory last salvaged */ 


uid of superior master dir */ 

up one each call to sum$dirmod */ 
pad to make it a 64 word header +/ 
checksummed from uid on */ 

uid of parent dir */ 


dci version_number_2 fixed bin int static options (constant) init (2); 


/* 


END INCLUDE FILE 


dir_header.incl.pli 


+/ 


i a A 


include.+*, hard.sourc 


F8OA 


- Nat to be reproduced 


dir_header.incl.pl1 


Page 18 


etter arent ienetce te SE ESP Rh Anny Se a ttn A 


dir_ht.inct.pli segment tn: >Idd>include | contents modified: 


entry modified: 03/10/82 0836.5 


/* BEGIN INCLUDE FILE ... dir_ht.incl.plt */ 
del htp ptr; 
dc! 1 hash_table based (htp) aligned, /* htp = ptr(dp,active_hardcore_data$htrp) */ 
2 modify bit (36) unal, 
2 type bit (18) unal, /* type «= dir hash table */ 
2 size fixed bin (17) unal, /* size of current dir hash table entry */ 
2 name_rp (0:1) bit( 18) unal, /* rel ptr of name entry = */ 
2 checksum bit (36) unal, 
2 owner bit (36) unal; 
/* otherwise rel ptr to name */ 
/* END INCLUDE FILE ... dir_ht.incl.pli */ 
include *, hard. source dir_ht.incl.pit 


pt to be reproduced 


10/19/76 


1420.6 


P-ge 
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a A te A A 


dir_link.incl.pi1 segment in: >1dd> include contents modified: 02/24/76 1923.5 
entry modified: 07/30/82 1442.9 


/* BEGIN INCLUDE FILE ... dir_link.incl.pli ... last modified August 1974 for nss */ 


/* Template for link. Note that it is identical to entry for first 24 words. */ 


dct 1 link based (ep) aligned, 


(2 efrp bit (18), /* forward rel ptr to next entry */ 
2 ebrp bit (18), /* backward rel ptr to previous entry */ 
2 type bit (18), /* type = dir link */ 
2 size fixed bin (17), /* size of link in words */ 
2 uid bit (36), /* unique id of entry */ 
2 dtem bit (36), — /* date-time entry modified */ 
2 bs bit (1), /*+ entry switch = 1 if entry */ 
2 padO bit (17), 
2 nnames fixed bin (17), /* number of names for this entry */ 
2 name_frp bit (18), /* rel pointer to start of name list */ 
2 name_brp bit (18), /* rel pointer to end of name list */ 
2 author, /* user who created entry */ 
3 pers_rp bit (18), /* name of user who created entry */ 
3 proj_rp bit (18), ‘ /* project of user who created entry +*/ 
3 tag char (1), /* tag of user who created entry */— 
3 padi char (3), 
2 primary_name bit (504), /* first name on name list +*/ 
2 dtd bit (36), /* date time dumped +/ 


2 pad2 bit (36), 


/* the declarations below are only applicable to links */ 


2 pad3 bit (18), 
2 pathname_size fixed bin (17), /* number of characters in pathname */ 


2 pathname char (168 refer (pathname_size))) unaligned, /* patiname of link */ 
2 checksum bit (36), /* checksum from uid */ 


2 owner bit (36); /* uid of containing directory */ 


incilude.+**, hard.source : dir_link.incl.pli Page 20 


/* END INCLUDE FILE ... dir_link.incl.plt */ 


inciude *, hard.source _ dir_link.incl.p*' P-qe 21 


ot to be reproduced 


dir_name.incl.pii segment in: >Idd>include contents modified: 10/19/76 1420.6 
entry modified: 03/10/82 0836.5 


/* BEGIN INCLUDE FILE ... dir_name.inci.pli ... last modified Nov 1975 for nss +¢/ 


/* Template for names of branches or links. Length = 14 words. */ 


dcl np ptr; 
dcl 1 names based aligned, /* based on ptr(dp,ep->entry.name_frp) +/ 
2 fp bit( 18) unaligned, /* rel ptr to next name */ 
2 bp bit( 18) unaligned, /* rel ptr to prev name */ 
2 type bit (18) unaligned, 7* type = dir name */ 
2 size fixed bin (17) unaligned, /* size of dir name */ 
2 entry_rp bit(18) unaligned, /* rel ptr to entry */ 
2 ht_index fixed bin(17) unaligned, /* index of hash table entry */ 
2 hash_thread bit (18) unal, /* relative ptr to next hash entry */ 


2 pad3 bit (18) unal, 


2 name char(32) aligned, 


2 checksum bit (36), /* checkS5um from entry_rp */ 
2 owner bit (36); _/* uid of entry */ 
/* END INCLUDE FILE ... dir_name.incl.pl1 */ 
include.+*+*, hard. source dir_name. incl .pli : Page 22 
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dirlockt.incl.plit segment 


entry modif 


>Idd> include 
03/09/83 1401.4 


in: 
fed: 


contents modified: 03/09/83 


a Sa ee Se RNY Pee aunts nde PEE rR SS nh trent A ER Nr A See Fr ET pat ANREP REY fA ete ew rat en A hen eR a 


/* BEGIN INCLUDE FILE ..... dirlockt.incl.plft ..... +/ 
/* Modified BIM 1/83 cleanup to multi-read lock */ 
/* format: style3,idind25 */ 
deci dirlockt_seg$ ext; /* 
dcl dirlocktp ptr; /* 
del, 1 dirlackt based (dirlocktp) aligned, 
. /* 
2 lock bit (36), /* 
2 ind fixed bin (35), /* 
2 notify _sw bit (1), 
2 last fixed bin (17), /* 
2 highest_last fixed bin (17), /* 
2 counter (1:59) fixed bin (35), /* 
2 dirlock (1: 10000) aligned like dir_! 
/* 
declare dir tock ptr pointer; 
declare 1 dir_lock aligned based (dir_lock_ptr) 
2 pid bit (36), /* 
2 ind bit (36) aligned, /* 
2 notify_sw bit (1) unaligned, /* 
2 salvage_sw bit (1) unaligned, /* 
2 padi bit (34) unaligned, 
2 lock count fixed bin (35); /* 
/* 
/* 
e 
’ fee END dirlockt.incl.pt i ..... af 
include, hard.source 


dirtockt.inel 


lot to be reproduced 


name of the segment containing the directory locks +/ 


pointer to the dirlock table */ 


Table of locks for direcyories */ 
Lock for the table itself */ 
Event for the above lock */ 


Index of the last entry currently used */ 
Highest index ever used */ 

count({) = number of times entry { was used */ 
ock; . 
entry for a directory lock */ 


pid of the process that locked the dir for write */ 
uid of the directory - also used as event id */ 

ON if one or more processes are waiting for the tock */ 
ON if dir was locked for salvage */ 


POSITIVE --> writte_lock */ 


NEGATIVE --> -number of lockers */ 
ZERO --> not locked */ 


-F 


1400.0 
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disk pack.incl.plit : segment “in: >Idd>include contents modified: 05/20/82 1037.5 
entry modified: 05/20/82 1047.6 


/* BEGIN INCLUDE FILE...dtsk_pack.incl.plit last Modified January 1982 for new volume map a/ 
/* 

All disk packs have the standard ltayout described below: 

Record 0O : : contains the label, as declared in fs_vol_ tabel.incl.plit. 

Record 1 to 3 ; contains the volume map, as declared in vol_map.incl.plt 

Record 4 to §& : contains the dumper bit map, as declared in dumper _bit_map.incl.plit 

Record 6 : contains the vtoc map, as declared in vtoc_map.incl!.pti 

Record 7 : formerly contained bad track list; no longer used. 

‘ Records 8 to n- 4 : contain the array of vtoc entries; ( n is specified in the label) 
each record contains 5S 192- word vtoc entries. The last 64 words are unused. 
Records n to N-1 : contain the pages of the Multics segments. ( N is specified in the label) 


Sundry partitions may exist within the region nm to N-1, withdrawn or not as befits the meaning 
of the particular partition. 


A conceptual declaration for a disk pack could be: 


dcl {1 disk_pack, 


2 label_ record (O : O) bit(36 * 1024), 
2 volume_map_record (4: 3)  bit(36 * 1024), 
2 dumper_bit_map_record (4 : 5) bit(36 * 1024), 
2 vtoc_map_record (6 : 6) bit(36 * 1024), 
2 spare_record (7: 7) bit(36 * 1024), 
2 vtoc_array_records (8 : n-1), 
3 vtoc_entry (5 ) bit(36 * 192), 
3 unused bit(36 * 64), 
2 Multics pages_records (n : N-1) bit(36 * 1024); 
*/ 
dct (LABEL_ADOR init (0), /* Address of Volume Label */ 
VOLMAP_ADDR init (1), /* Address of first Volume Map record */ 
DUMPER_BIT_MAP_ADDR init (4), /* For initial release compaitiblity */ 
VTOC_MAP_ADDR init (6), /+* Address of first VTOC Map Record */ 
VTOC_ORIGIN init (8), /* Address of first record of VTOC */ 
SECTORS PER _VTOCE init (3), 
VTOCES_PER_RECORD init (5), ; 
DEFAULT _HCPART_SIZE init? (1000), /* Size of Hardcore Partition */ 
MAX _VTOCE _PER _PACK init (31774)) /* Limited by size of VTOC Map */ 


fixed bin (17) int static options (constant) ; 


inciude.**, hard.source disk _pack.incl.pl1 Page 24 
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/* 


tne tude 


vh 


END INCLUDE FILE...disk_pack.incl.plit 


«, hard.source 


Jot to be reproduced 
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dskdcl.inc!.plit segnent in: >1dd>include contents modified: 08/17/82 1421.1 
entry modified: 08/17/82 1426.7 ; 
/* Begin include file ...... dskdcl.incl.plt +*/ 
/* Structures used by the Disk DIM */ 
/* format: style4,deinl, insnl, tree, ifthenstmt, indnoniterend */ 
dci disk seg ext; /* disk data segment +*/ 
dct disksp ptr, /* pointer to disk subsystem info */ 
diskp ptr; /* pointer to disk DIM info structure */ 
dct 1 disk_data based (disksp) aligned, /* disk subsystem information */ 
2 subsystems fixed bin, /* number of subsystems +*/ 
2 free_offset bit (18), /* offset of first unused location in segment */ 
2 status_mask bit (36), /* mask for checking for disk error */ 
2 last _queue_time fixed bin (71). /* for dump anatysis, to interpret Q times */ 
2 pad (2) fixed bin, 
2 array (32), /* per subsystem info */— 
( 
3 offset bit (18), /* location of data for this subsystem */ 
3 pad bit (18), 
3 name char (4) 
) unal; /* name of subsystem */ 
dcl 1 disktab based (diskp) aligned, /* control structure for DIM’s */ 
2 lock bit (36) unal, /* data base Jack */ 
2 nchan fixed bin, /* number of disk channeis */ 
2 ndrives fixed bin, /* highest disk drive number */ 
2 channels_online fixed bin, /* number of disk- channels derost ys: in use */ 
2 dev_busy bit (64), -/* busy bit for each device */ 
2 dev_queued bit (64), /* requests queued bit for each device */ 
2 wq (0:1) like qht, /* wait queue head/tail */ 
2 free_q like qht, /* free queue head/tail */ 
2 abs_mem_addr fixed bin (26) unsigned, /* absolute memory address of this structure */ 
2 pad fixed bin, j 
2 errors fixed bin, -/* error count +*/ 
2 ferrors fixed bin, /* fatal error count */ 
2 edac_errors fixed bin, /* count of EDAC correctable errors */ 
2 pg_io_count (0:1) Ftxed bin, /* count of page I/0 operations */ 
2 vt_io “count (0:1) fixed bin, /* count of VTOCE 1/0 operations */ 
2 call lock _meters like disk_lock_meters, /* lock meters for call side of DIM */ 
2 int_lock_meters like disk_lock_meters, /* lock meters for interrupt side of DIM */ 
2 alloc_wait_meters Jlike disk_ltock_meters, /+ meters for queue entry allocations */ 
2 run_lock_meters like disk_lock_meters, /* lock meters for run calls +/ 
2 pg_wait (0:1) fixed bin (52), /* total time spent waiting for page I/O */ 
° 2 vt_wait (0:1) fixed bin (52), /* total time spent waiting for VTOCE I/O */ 
2 pg_lo (0:1) fixed bin (52), /* total time spent doing page 1/0 */ 
2 vt_io (0:1) fixed bin (52), . /* total time spent doing VTOCE 1/0 +*/ 
2 queue (64) like quentry, /* queue entries +/ 
2 chantab (8) like chantab, /* channel information table */ 
include.+*+*, hard.source dskdcl.incl.pit Page 
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4Zpage ; 
dc} 


2 devtab (0 refer (disktab.ndrives)) like devtab; 


qp ptr, 


cp ptr; 


dcl i] 


dct. 1 


err et nt FA er peers ts Sr rn no SE Hr A eR te 


tncl.plt 


include 


quentry based (qp) aligned, 


next bit (18), 

write sw bit (1), ° 
sect_ sw bit (1), 

testing bit (1), 

retry bit (1), 

used bit (1), 

swap bit (1), 

cylinder fixed bin (11), 

pdi unsigned fixed bin (6), 
coreadd bit (24), 

dev unsigned fixed bin (6), 
sector bit (21), 

pad bit (9), 

n_sectors fixed bin (6) unsigned, 
time fixed bin (36) poatones 
unal; 


wWwNONNNUANAO MANSY ADH 


chantab based (cp) aligned, 
chx fixed bin (35), 
foi_ctx fixed bin (35), 
statusp ptr, 

chanid char (8), 


pado bit (18), 
in use bit (1), 
active bit (1), 
rsr bit (1), 
prior bit (1), 
ioi_use bit (1), 
fnop bit (1), 
broken bit (1), 
actton_code bit 
padt bit (9) 
unal, 


(2), 


qrp bit (18), 

pad2 bit (3), 
command bit (6), 
erct fixed bin (8) 
unal, 

select_data, 


hee ee ee ee 


3 limit bit (12), 

3 mbz bit (3), 

3 sector bit (21) 

) unaligned, 
2 connect_time fixed bin (52), 
2 connects fixed bin, 


*, hard. source 


jot to be reproduced 


dskdcl. 


device information table */ 


pointer to queue entry */ 

pointer to channel information table */ 

queue entry +/ 

index to next queue entry */ 

non-zero for write operation +*/ 

non-zero for single sector operation «/ 

non-zero if quentry is for disk ready test */ 

non-zero if retry has been performed on broken device */ 
non-zero if queue entry tn use */ 

disk cylinder number */ 


pdi of device */ 

memory address for data transfer: */ 
disk device code */ 

disk sector address */ 


number of sectors for sector 1/0 */ 
low-order microsecond clock at queue */ 
time entry was queued */ 


channel information table */ 
fo_manager channel index */ 

{oi channel table index */ 

pointer to hardware status word */ 
channel name +*/ 


channel being used */ 
channel active */ 

RSR in progress */ 
current request */ 
channel usurped by IOI */ 
non-zero if channel inoperative */ 
non-zero {tf channel broken */ 

saved from status */ 


non-zero if 
non-zero {tf 
non-zero if 
priority of 
non-zero {if 


rel ptr to queue entry */ 
peripheral command +*/ 


error retry count */ 
data passed to IOM on select */ 


limit on number of sectors */ 
sector address */ 


time of last connect */ 
count of connects performed */ 


27 


detailed status (0:17) bit (8) unal, 
rstdcw bit (36), 

scdcw bit (36), 

sddcw bit (36), 

dcdew bit (36), 

dddew bit (36), 

dscdew bit (36), 

dsddcw bit (36), 

rssdew bit (36), 

status bit (36) aligned; 


RDN ADA Pb A 


*page ; 


dc} 


dcl 


dct 


dc} 


deci 


dcl 


4 qht aligned based, 
2 (head, tail) bit (18) unal; 


dp ptr, 
pvtdip ptr; 


1 devtab based (dp) aligned, 


pyvtx fixed bin (8), 
inop bit (1), 

was_ broken bit (1), 
broken bit (1), 
abandoned bit (1), 
pad bit (11), 

buddy unsigned fixed bin (6),- 
pdi unsigned fixed bin (6) 

unal, 

queue_count fixed bin (8), 
cylinder fixed bin (11), : 
seek distance fixed bin (35, 18), 
read _ count fixed bin, 

write count fixed bin, 

time_inop fixed bin (52); 


RPRMNOHONON YHOO NHHADNNHD& 


1 pvtdi based (pvtdip) aligned, 


sx fixed bin (11), - 
usable _sect_per_cy! fixed bin (11), 
unused sect_per_cyl fixed bin (11): 
unal; . 


wh 


1 disk _lock_meters based aligned, 
2 count fixed bin, 
2 waits fixed bin, 
2 wait_time fixed bin (52); 


( 

RST_LISTX init (1), 

SC_LISTX init (2), 

DSC _LISTX init (6), 

RSS LISTX init (8) 

) fixed bin (12) static options (constant); 


/* End of include file ...... dskdcl.incl.plt */ 


include.**, hard.source 
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dskdcl.incl.pli 


detailed status bytes */ 
restore command +*/ 

select command */ 

select data xfer */ 
command to read or write +*/ 
data xfer DCW */ 

RSR command '*/ 

RSR data xfer */ 

RSS command */ 

saved status +*/ 


queue head/tail structure */ 


pointer to device information table */ 
pointer to dim_info in PVT entry */ 


device information table */ 


index of PVT entry for device */ 
device inoperative */ 

device previously broken +/ 
device down */ 

device lost and gone forever */ 


other device on this spindle or O */ 


primary device index */ 

count of requests queued for device */ 
current cylinder position */ 

average seek distance */ 

count of reads */ 

count of writes */ 

time drive became inoperative */ 


disk DIM info. in PVT entry */ 


structure index */ 
# of usable sectors on disk cylinder */ 


4 of unused sectors at end of cylinder +*/ 


lock meters for disk DIM */ 
total number of attempts */ 
number of attempts which required waiting */ 
total time spent waiting */ 


listx for restore */ 
listx for select */ 
listx for RSR */ 


listx for RSS */ 


Page 
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ect_structures.incl.plit 


/* 


BEGIN INCLUDE FILE 


/* format: styled */ 


del 
del 


dc} 


dc} 
dcl 
dc} 
dct 


dcl 
dc} 


dct 


include 


ect_ptr 
ectep 


1 ect_header 
2 ect_areap 
2 ect_area_size 
2 flags, 
3 call_priority 


3 unused 


2 count 


2 entry_list_ptrs 


3 firstp 
3 lastp 
2 meters, 


ect_structures. inc!.pli 


ptr; 
ptr; 


ptr, 


fixed bin (19), 


bit (1) unal, 


bit (17) unal, 
3 mask_call_count 
fixed bin (17) unal, 
(0:5) fixed bin, 


(4), 


ptr, 
ptr, 


3 total_wakeups fixed bin 
3 total_watt_wakeups 


fixed 


3 total _call_wakeups 


2 seed 
2 ittes_ tossed 
2 Fill ° 


TOTAL 

WAIT 

CALL 
EV_CALL_MESSAGE 


ITT_MESSAGE 
EV_MESSAGE 


1 wait_channel 
2 word_O, 
3 unusedt 
3 type 
2 next_chanp 


*, hard. source 
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fixed 
fixed 
fixed 


bin 


bin 
bin 
bin 


(33), 
(33), 
(33), 


(33), 
(33), 


(5) fixed bin; 


fixed 
fixed 
fixed 
fixed 


fixed 
fixed 


bin 
bin 
bin 
bin 


bin 
bin 


static 
static 
static 
static 


static 
static 


segment 


in: >Idd>include contents modified: 09/30/81 


entry modified: 03/10/82 0837.0 


_alitgned based (ect_ptr), 


options (constant) init 
options (constant) Init 
options (constant) init 
options (constant) init 


opttons 
options 


aligned based (ectep), 


fixed bin (17) unal, 
fixed bin (17) unal, 
ptr unal, 


/* 


/* 


/* 


(constant) itnit 
(constant) init 


/* 


‘ay 
/* 


Jan 1981 */ 


points to base of Event Channel Table header */ 
points to event channel table entry */ 


structure of the Event Channel Table header */ 
pointer to area in which ect entries are allocated */ 


‘ number of words in ect area */ 


= "O"b {f wait chns have priority - default */ 
= "{"b if call chans have prtority */ 


number times event cal) chans masked +*/ 

totals of entries allocated */ 

O = number of entries, 1 = number of wait channels */ 
2 = number of call channels +*/ 

3 = number of call channe) messages */ 

4 = number of itt messages, 5 = number of messages */ 
head and tail of lists in ECT */ 

1 = wait channels, 2 = call channels */ . 

3 = cali channel messages, 4 = itt messages */ 

head of Tist */ 

tail of list */ 


total wakeups sent on all channels */ 

wakeups sent on wait channels */ 

wakeups sent on call channels */ 

used to generate uid portion of channel name */ 


number invalid ITT messages received, ignored */ 
pad to 36 words */ 


used to x count and entry_list_ptrs arrays */ 


OR at 
gasanso 


Event wait channel - type = WAIT */ 


= WAIT */ 
pointer to next watt channel */ 


ect_structures. ‘°cl.plit 


1358.8 
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dc 3 


dc) 


dc) 


dc} 


include. **, 


NR 


NON A PO 


prev_chanp 
word 3, 

3 unused2 

3 inhibit_count 
3 wakeup _count 
name 

first _ev_msgp 
last_ev_msgp 
unused3 


call_channel 


2 


NO RO ho 


NM RA db 


2 


word_O, 

3 priority 

3 type 

next _chanp 
prev_chanp 
word_3, 

3 call_inhibit 
3 inhibit_count 
3 wakeup_count 
name 
first_ev_msgp 
last_ev_msgp 
data_ptr 
procedure_value, 
3 procedure ptr 
3 environment_pt 


unused 


event_message 


2 


Rw Rh 


word_O, 

3 priority 

3 type 

next _ev_msgp 
message data 


chanp 
next _call_msgp 
unused2 


itt message 


2 


2 
2 
2 


word 0, 

3 unused i 

3 type 
next_itt_msgp 
message data 
unused2 


event _channel_name 


2 


2 
2 


ecte ptr 


ring 
unique_id 


hard.source 
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ptr unal, 


bit (1) unal, 

fixed bin (16) unal, 
fixed bin (18) unal 
bit (72), 

ptr unal, 

ptr unal, 

(4) fixed bin; 


aligned based (ectep 


fixed bin (17) unal, 
fixed bin (17) unal, 
ptr unal, 
ptr unal, 


bit (1) unal, 

fixed bin (16) unal, 
fixed bin (18) unal 
bit (72), 

ptr unal, 

ptr unal, 

ptr unal, 


ptr unal, 
r . 

ptr unal, 
fixed bin; 


aligned based, 


fixed bin (17) unal, 
fixed bin (17) unal, 
ptr unal, 

like event_message d 


ptr unal, 
ptr unal, 
(2) fixed bin; 


aligned based, 


fixed bin (17) unal,,. 
fixed bin (17) unal, 
ptr unal, 

like event_message d 
(4) fixed bin; 


aligned based, 
ptr unal, 


fixed bin (3) unal u 
fixed bin (33) unal 


unsigned, /* 


Ve /* 


unsigned, /* 


ata aligned, 
/* 
/* 
/* 
/* 


/* 


/* 
ata aligned, 


/* 


nsigned, /* 
unsigned; /* 


pointer to previous wait channel */ 


number of tinfes message reception has been inhibited */ 
number of wakeups received over this channel 


/ 


event channel name associated with this channel 
pointer to first message in queue */ 
pointer to last message in queue +/ 


pad to 12 words 


+/ 


Event call channel - type = CALL */ 


+/ 


indicated priority relative to other call chns */ 


= CALL */ 


pointer to next call channel */ 
pointer to prev call channel */ 


= "1"b if call to associated proc in progress */ 
number of times message reception has been inhibited */ 
number of wakeups received over this channel 


+f 


event channel name associated with this channel 


pointer to first message in queue */ 


pointer to last message in queue */ 
pointer to associated data base */ 


procedure tc call when message arrives */ 


pointer to entry point */ 


pointer to stack frame */ 
pad to 12 words */ 


Event message - 


type 


= EV_MESSAGE */ 


priority of call channel */ 


= EV_MESSAGE +/ 


pointer to next message. for this channel +t/ 


event message as returned from itpc_$block */ 
pointer to associated event channel */ 
pointer to next event call channel message */ 


pad to 12 words 


pointer to next itt message entry in ECT currently */ 


pad to 12 words 


+/ 


‘Itt message - type = 


+/ 


ITT_MESSAGE */ 


description of name of channel */ 
pointer to channel entry in ECT */ 


= null 


if fast channel */ 
ring number of ECT */ 


identified unique to the process */ 


ect_structures. incl.pli 


*/ 
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dc} 1 .fast_channel_name aligned based, /* description of name of of fast channel */ 


2 ecte_ptr ptr unal, : /* = null fast channel */ 
/* *= null full event channel +*/ 
2 ring fixed bin (3) unal unsigned, /* target ring number */ 
2 mbz bit (15) unal, . 
2 channel_index fixed bin (17) unal; /* number of special channel +/ 
dc} 1 event message data 
aligned based, , /* template for event message */ 
2 channel_id fixed bin (71), ' /* event channel name */ 
2 message fixed bin (71), /* 72 bit message associated with wakeup */ 
2 sender bit (36), /* process {f of sender */ 
2 origin, 
3 dev_signal bit (18) unal, , /* "1"b 1f device signal */ 
/* "O"b if user event */ 
3 ring ftxed bin (17) unal; /*-ring of sending process */ 
/* END INCLUDE file ... ect_structures.incl.plt +*/ 
inctude *, hard.source ect_structures.  ‘<t.plt 
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eve 


/* 
/* 


+/ 


/* END INCLUDE FILE 


incl 
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nt_wait_list.incl.plt 


BEGIN INCLUDE FILE 


segment in: >Idd>include contents modified: 06/07/79 1406.5. 


entry modified: 03/10/82 0836.7 


. event, wait _list.incl.pli */ 


ipc_$block wait list structure -- Must begin on an even word boundary. 


Written 9-May~79 by M. N. Davidoff. 


declare event_wait_list_n_channels 


declare event_wait_list_ptr 
declare i event_wait_list 
2 n_channels 


2 pad 
2 channel_id 


ude.*+*, hard.source 


- Not to he reoroduced 


fixed binary; 
pointer; 


aligned based (event_wait_list_ptr), 

fixed binary, /* number of channels in wait list */ 

bit (36), 

(event_' wat t_ list_n_ channels refer (event_watt_list.n_channels)) fixed binary (71); 
/* event channels to wait on */ 


event_wait_list.incl.pli */ 


event_wait_list.inel.plf 


fault vector. tne) .pli segment tn: >Idd>include contents modif ted: 
entry modified: 03/10/82 0836.9 


rr et A © SRR ert A A NI NT ft th tn er 


/* BEGIN INCLUDE FILE ... fault_vector.incl.pli ... last modified February 1981 */ 
del fvp ptr; ° /* pointer to the fault and interrupt vectors */ 
dcl t fv based (fvp) aligned, -/* fault and interrupt vectors */ 
2 ipair (0: 31), : /* interrupt pairs */ 
3 scu bit (36), : /* SCU instruction */ 
3 tra bit (36), /* TRA instruction */ 
2 fpair (0: 31), /* fault. pairs */ 
3 scu bit (36), /* SCU instruction «/ 
3 tra bit (36), /* TRA instruction */ 
2 i_tra_ptr (0: 31) ptr, _  /* ITS pair for interrupt TRA instruction */ 
2 i_scu_ptr (0: 31) ptr, /* ITS pair for interrupt SCU instruction */ 
2 f_tra_ptr (0: 31) ptr, /* ITS pairs for fault TRA instruction */ 
2 f_scu_ptr (0: 31) ptr; /* ITS pairs for fault SCU instruction */ 


/* Fault Types by fault number 


dc! (FAULT_NO_SDF init (0), /* Shutdown 
FAULT_NO_STR init (1), /* Store «/ 
FAULT_NO MME init (2), /* Master Mode Entry 1 
FAULT_NO_Ft init (3), /* Fault Tag 1 
FAULT_NO_TRO init (4), /* Timer Runout 
FAULT_NO_CMD init (5), /* Command 
FAULT_NO_DRL init (6), /* Derail 
FAULT_NO_LUF init (7). /* Lockup 
FAULT_NO_CON init (8), /* Connect 
FAULT_NO_PAR init (9), /* Parity 
FAULT_NO_IPR init (10), /* Tllegal Procedure 
FAULT _NO_ONC init (11), /* Operatton Not Complete 
FAULT_NO SUF init (12), /* Startup 
FAULT_NO_OFL {init (13), /* Overflow 
FAULT_NO DIV tnit (14), /* Divide Check 
FAULT_NO_EXF init (15), /* Execute 
FAULT_NO_ DFO init (16), /* Directed Fault O (Segment Fault) 
FAULT_NO_DF1 init (17), /* Directed Fault 1 (Page Fault) 
FAULT_NO_DF2 init (18), /* Directed Fault 2 
FAULT_NO_DF3 init (19), /* Directed Fault 3 
FAULT_NO_ACV ‘tnit (20), /* Access Violation 
FAULT_NO_MME2 init (21), /* Master Mode Entry 2 
FAULT_NO_MME3 init (22), /* Master Mode Entry 3 
FAULT_NO_MME4 init (23), /* Master Mode Entry 4 


FAULT_NO_F2 init (24) /* Fault Tag 2 (Linkage Fault) 


FAULT_NO_F3 = tnit (25), /* Fault Tag 3 
/* Fault Numbers 26-30 unassigned 
FAULT_NO_TRB init (31) /* Trouble 


) fixed bin (17) int static options (constant); 


inciude *, hard.source fault_vector.in pit 
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/* END INCLUDE FILE ... fault _vector.incli.plit */ 


ult_vector.incl.plf! Page 34 
include,+*, hard. source fault _vector.incl.pl{ ag 
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fgbx.incl.plii segment tn: 
entry modified: 


/* BEGIN INCLUDE FILE ... fgbx.incl.pit «/ 

/* last modified 5/3/77 by Noel I. Morris: */ 

/* Modified 8/79 by R.J.C. Kissel to add FNP blast message. */ 
/* Modified 7/82 BIM for recognizable sentinel field */ 


/* The contents of this segment are data shared by Multics and BOS. 


>Idd>itnclude 


09/17/82 1333.3 


ar a aoa 


This segment occupies the 2nd, 3rd, 4th, and Sth 16-word blocks of the BOS toehold. */ 


del flagbox$ ext; 
dct fgbxp ptr; 


dc} fgbx based (fgbxp) aligned, 


1 ‘ 
2 flags (36) bit (1) unal, /* communications switches */ 
2 sit_segno bit (18), /* segment 4 of the SLT */ 
2 padi fixed bin, , : 
2 rtb, /* return to BOS info */ 
(3 ssenb bit (1), /* "("b 1f storage system enabled */ 
3 call_bos bit (1), ; /* "1"b {f BOS. called by operator */ 
3 shut bit (1), - Je “{"b 1f BOS called after shutdown */ 
3 mess bit (1), /* “1"b if message has been provided */ 
3 alert bit (1), /* “1"b 4f audible alarm to be sounded */ 
3 pad bit (25), . ; 
3 bos_entry fixed bin (5)) unal, /* type of entry into BOS 


O => XED 10002 (BOS entry). 
1 => XED 10004 (Multics entry) 
2 => XED 10000 (manual entry) */ 


sentinel char (32) aligned, 


/* set by BOS (for now) */ 


2 

2 sst_sdw bit (72), /* set by init_sst */ 

2 he_dbr bit (72), /* set by start_cpu, fdle DBR */ 

2 message char (64), /* message for return to BOS */ 

2 fnp_biast char (128); . {* message for FNP use when Multics is down. */ 


declare FLAGBOX_SENTINEL char (32) init ("Flagbox & Toehold Valid®) int static options (constant); 


/* END INCLUDE FILE ... fgbx.incl.pif «/ 
include *, hard.source fgbx.incl.pli 
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fs dev_types.incl.plt segment in: >Idd> include conténts modified: 02/09/81 1416.2 


/* 


entry modified: 03/10/82 0836.8 


Begin include file ...... fs _dev_types.inci.plt */ 


/* Modified 5/19/76 by N. I. Morris +/ 


/* Modified 12/27/78 by Michael R. *Jordan to correct MSSO500 information */ 
/* Modified 4/79 by R.J.C. Kissel to add msu0SO1t information. */ 
dci (maxdevt init (7), /* maximum legal devt «/ 
bulkdevt init (1), /* bulk store devt +/ 
msuOSO0Odevt init (2), /* MSUO500O device type */ 
msu045idevt init (3), /* MSU0451 device type */ 
msuO0450devt init (3), /* MSUO450 device type */ 
msuO400devt init (4), /* MSUO0400 device type */ 
dsut9idevt init (4), . /* DSUI9t device type */ 
dsul90devt init (5), /* DSU190 device type */ 
dsutBidevt init (6), /* DSU181 device type */ 
msu0SOtdevt init (7) /* MSUOSO1 device type */ 
) fixed bin (4) static options canntaney: 
dct MODEL (10) fixed bin static options (constant) init /* Known device model numbers +*/ 
(Oo, 500, 451, 450, 400, 402, 191, 190, 181, 501); 
dct MODELX (10) fixed bin static options (constant) init /* translation from model number to device type */ 
(1, 2, 3, 3, 4, 4, 4, 5, G, 7); 
dci MODELN (7) fixed bin static options (constant) init /* translation from device type to model number */ 
(Oo, 500, 451, 400, 190, 181, S01); ; 
dci device_names (7) char (4) aligned static options (constant) init ( /* device names indexed by device type */- 
“bulk”, "d500", “d451", “d400", "di90", “diBi", "d501"); 
dci media_removable (7) bit (1) static options (constant) init /* ON => demountable pack on device */ 
("O"b, "O"b, “i"b, "“7"b, "“4"b, "{"b, "O"b); 
dct shared_spindle (7) bit (1) static opt tons peeneene) init /* ON => 2 devices per spindle */ 
( "O"b, “ 1 "bd, 4Q" b, “O"b, “O"b, "O"b, a4 “b); van 
dc! rec_per_dev (7) fixed bin static options (constant) tnit /* table of # of records on each device */ 
(O, 38258, 38258, 19270, 14760, 4444, 67200); 
dc! cyl_per_dev (7) fixed bin static options (constant) tnit /* table of # of cylinders on each device */ 
(O, 814, 814, 410, 410, 202, 840); 
dcl rec_per_cy! (7) fixed bin static options (constant) init /* table of # of records per cylinder on each device */ 
(O, 47, 47, 47, 36, 22, 80); ; 
dcl sect_per_cy! (7) fixed bin static options (constant) init /* table of # of sectors per cylinder on each device +/ 
(0, 760, 760, 760, 589, 360, 1280); 
dcl sect_per_rec (7) fixed bin static options (constant) init /* table of # of sectors per record on each device */ 
(O. 16, 16, 16, 16, 16, 16); 
include.**, hard. source fs dev_types.incl.pti ~~ Page 
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dcl tracks_per_cy! (7) fixed bin static options (constant) init /* table of # of tracks per cylinder on each device */ 
: (O, 19, 19, 19, 19, 20, 20); 


dct sect_per_track (7) fixed bin static options (constant) init /* table of # of sectors per track orn each device */ 
(0, 40, 40, 40, 31, 18, 64); 


dcl words_per_sect (7) fixed bin static options (constant) init /* table of 4 of words per sector on each device */ 
(Oo, 64, (64, 64, 64, 64, 64); 


dcl first_rec_num (7) fixed bin Static options (constant) init /* table of # of first record on each device */ 
(Oo, O, ~O, 0, oO, O, O); 


dcl tast_rec_num (7) fixed bin (18) static options (constant) init /* table of # of last record on each device */ 
(O, 38257, 38116, 19128, 14651, 4399, 67199); : 


dc! first_sect_num (7) fixed bin (24) static options (constant) init /* table of # of first sector for each device */ 
(Oo, 0, 0, O, O, O, O); 


dcl last_sect_num (7) fixed bin (24) static options (constant) init /* table of # last sector number for each device */ 
(0, 618639, 616359, 309319, 239722, 71999, 1075199); 


dc! first_alt_sect_num (7) fixed bin (24) static options cone ane): init /* Cite of # of first sector of alt partition */ 
(Oo, 638400, 616360, 309320, 239723, 72000, 1075200); : ; 


dct last_alt_sect_num (7) fixed bin (24) static options (écuatent) init /* table of # of last sector of alt Pars teton «/ 
(Oo, 639919, 618639, 311599, 241489, 72719, 1077759); 


det last_physical_sect_num (7) fixed bin (24) static options (constant) init /* table of 4 of last sector on device (includes T&D c 
ylinders) */ 
(O, 639919, 619999, 312359, 242249, 72959, 1077759): 


dcl dev_time (7) float bin (27) static options (constant) init /* table of average access times for each device */ 
(384e0, 3318760, 3318760, 34722e0, 46995e0, 52631e0, 33187e0); 


/* End of include file ...... fs_dev_types.incl.plt */ 
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fs_types.incl.plf segment in: >tdd>tnclude - contents modified: 


entry modified: 03/10/82 0836.6 


/* BEGIN INCLUDE FILE ... fs_types.incl.plt +*/ 

dc! ACCESS _NAME_TYPE bit (18) static options (constant) init ("000001"b3); 
dct ACLE_TYPE bit (18) static options (constant) init ("000002"b3); 

dcl DIR_HEADER_TYPE bit (18) static options (constant) init ("000003"b3); 
dcl DIR_TYPE bit (18) static options (constant) init ("000004"b3);_ 

dct LINK_TYPE bit (18) static options (constant) init ("O000005"b3); 

dcl NAME_TYPE bit (18) static options (constant) init ("000006"b3); 

dcl SEG_TYPE bit (18) static options (constant) init ("000007"b3); 

dct HASH_TABLE_TYPE bit (18) static options (constant) init ("000013"b3); 
dc! access_name_type fixed bin static options (constant) init (1); 

dc! acle_type fixed bin static options (constant) init (2); 

dci dir_header_type fixed bin static options (constant) init (3); - 

dci dir_type fixed bin static options (constant) init (4); 

dc! link_type fixed bin static options (constant) init (5); 

dcil name_type fixed bin static options (constant) init (6); 

dcl seg_type fixed bin static options (constant) init (7); 

dci hash_table_type fixed bin static options (constant) init (11); 

/* END INCLUDE FILE ... fs_types.incl.pit */ 

tne, 3.%**, hard.source fs_types.inc’ ‘1 
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fs_vol_label.inci.pli a segment in: »>Idd>include contents modified: 05/20/82 1037.5 
entry modified: 05/20/82 1047.6 
fe BEGIN INCLUDE FILE ... fs_vol_label.inct.pii .. last modified January 1982 for new volume map format «/ 
/* This ts the label at fixed location of each physical volume. Langit: 4 page */ 
del labelp ptr; 
dc! 1 label based (labelp) aligned, 
/* First comes data not used by Multics.. for compatibility with GCOS */ 
2 gcos (5*64) fixed bin, 
/* Now we have the Multics label */ 


Multics char (32) tntt (“Multics Storage System Volume"), /* Idantifier */ 


2 
2 version fixed bin, /7* Version 1 */ 
2 mfg_serial char (32), . /* Manufacturer’s serial number */ 
2 pv_name char (32), /* Physical volume name. */ 
F 2 Iv_name char (32), /* Name of logical volume for pack */ 
2 pvid bit (36), /* Unique ID of this pack */ 
2 Ivid bit (36), /* unique 1D of its logical vol */ 
2 root_pvid bit (36), /* unique 1D of the pack containing the root. everybody must agree. */ 
2 time_registered fixed bin (71), /* time imported to system */ 
2 n_pv_in_lv fixed bin, /* # phys volumes tn logical */ 
2 vol_size fixed bin, /* total size of volume, in records +*/ 
2 vtoc_size fixed bin, A /* number of recs in fixed area + vtoc */ 
2 not_used bit (1) unal, /* used to be multiple class */ 
2 private bit (1) unal, /* TRUE if was registered as private +/ 
2 flagpad bit (34) unal, : 
2 max_access_class bit (72), /* Maximum access class for stuff on volume */ 
2 min_access_class bit (72), /* Minimum access class for stuff on volume */ 
2 password bit (72), /* not yet used */ 
2 padi (16) fixed bin, a +4 
2 time_mounted fixed bin (71), /* time mounted */ 
2 time_map_updated fixed bin (74), /* time vmap known good +*/ 


/* The next two words overlay time_unmounted on pre-MR10 systems. This 
forces a salvage if an MR10 pack is mounted on an earlier system. 


«f 

2 volmap_version fixed bin, /* version of volume map (currently 1) */ 

2 pad6 fixed bin, Z 

2 time_salvaged fixed bin (71), /* time salvaged */ 

2 time_of_boot fixed bin (71), /* time of last bootload */ 

2 time_unmounted fixed bin (71), /* time unmounted cleanly */ 

2 last_pvtx fixed bin, /* pyvtx in that PDMAP +*/ 

2 padia (2) fixed bin, 

2 err_hist_size fixed bin, /* size of pack error history */ 

2 time_last_dmp (3) fixed bin (71), /* time last completed dump pass started */ 
include ~«, hard.source fs_vol_label.in  plt ro o4e 
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2 time_last_reloaded fixed bin (71), /* what it says */ 
2 pad2 (40) fixed bin, 5 es 
2 root, 
3 here bit (1), /+ TRUE if the root is on this pack *+/ 
3 root_vtocx fixed bin (35), /* vTOC index of root, if it is here +/ 
3 shutdown_state fixed bin, /* Status of hierarchy */ 
3 pad7 bit (1) aligned, ; 
3 disk_table_ vtocx fixed bin, /* VTOC index of disk table on RPV +/ 
3 disk_table_uid bit (36) aligned, /* UID of disk table */ 
3 esd_state fixed bin, /* State of esd: +/ . 
2 volmap_record fixed bin, /* Begin record of volume map +t/ 
2 size of volmap fixed bin, /* Number of records in volume map */ 
2 vtoc_map_record fixed bin, /* Begin record of VTOC map */ 
2 size_of vtoc_map fixed bin, /* Number of records in VTOC map +*/ 
2 volmap_unit_size fixed bin, /* Number of words per volume map section */ 
2 vtoc_origin_record fixed bin, /* Begin record of VTOC */ 
2 dumper_bit_map_record fixed bin, /* Begin record of dumper bit-map */ 
2 vol_trouble_count fixed bin, /* Count of inconsistencies found since salvage */ 
2 pad3 (52) fixed bin, 
2 nparts fixed bin, /* Number of special partitions on pack */ 
2 parts (47), 
3 part char (4), : /* Name of partition */ 
3 frec fixed bin, /* First record */ 
3 nrec fixed bin, /* Number of records */ 


3 padS fixed bin, 
2 pad4 (5+*64) fixed bin; 


dcl Multics_ID String char (32) init ("Multics Storage System Volume") static; 


/* END INCLUDE FILE fs_vol_label.incl.plt */ 


inc 2.**, hard.source fs_vol_label. Tipit 
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he_lock.inel.pif . segment in: >Idd>include contents modified: 04/14/82 1336.1 
entry modified: 04/14/82 1337.7 


TY 


/* Begin include file hc_lock.incl.plf BIM 2/82 */ 
/* Lock format suitable for use with lock$tock_ fast, unlock fast */ 


/* format: styled +*/ 


declare tock ptr pointer; 

declare 1 lock aligned based (lock_ptr), 
2 pid bit (36) aligned, /* holder of tock */ 
2 event bit (36) alitgned, /* event associated with lock */ 
2 flags aligned, 


3 notify_sw bit (1) unaligned, 
3 pad ‘ bit (35) unaligned; /* certain locks use this pad, tike dirs */ 


/* End include file hc_lock.incl.plt */ 
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itt _entry.incl.plt 


/* BEGIN INCLUDE FILE 
/* format: style? */ 
dct itte ptr 
dcj 1 itt_entry 
2 next_itt_relp 
2 pad 
2 sender 
2 origin, 
3 dev_signal 
3 ring 
2 target_id 
2 channel_id 
2 message 
/* END INCLUDE FILE 
ines .**, hard. source 
F8OA ~ Not to be reproduced 


segment 


In: >»Idd>include 


entry modified: 03/10/82 0837.0 


itt_entry.incl.pli 


ptr; 


aligned based (itte_ptr), 
bit’ (18) unaligned, 

bit (18) unaligned, 

bit (36), 


bit (18) unaligned, 

fixed bin (17) unaligned, 
bit (36), 

fixed bin (71), 

fixed bin (71); 


itt_entry.incl.plt */ 


itt_entry. inc 


Feb 1981 */ ' 


/* 


/* 
/* 


pointer to entry in ITT */ 


declaration of single entry in the ITT */ 
thread of relative pointers +*/ 


. id of sending process */ 


origin of event message */ 

O = user-event, 1-= device-signal */ 

if user-event, sender’s validation ring */ 
target process’ id */ 

target process’ event channel */ 

event message */ 


1 


contents modified: 


08/06/81 
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; 42 


kst.incl.plt : segment in: >dd>include contents modified: 03/14/83 1654.3 
entry modifted: 03/14/83 1655.6 


/* BEGIN INCLUDE FILE - - - kst.incl.pli - - - last modified March 1976 by R. Bratt */ 


dc!l pds$kstp ext ptr, 


(kstp, kstep) ptr; 


dc! 1 kst altgned based (kstp), /* KST header declaration */ 
2 lowseg fixed bin (17), /* lowest segment number described by kst */ 
2 highseg fixed bin (17), /* highest segment number described by kst */ 
2 highest_used_segno fixed bin (17), /* highest segment number yet used */ 
2 Ivs fixed bin (8), /* number of private LVs this process is connected to */ 
2 time_of_bootload fixed bin (71), /* bootload time during prelinking */ 
2 garbage_collections fixed bin (17) unaligned, /* KST garbage collections */ 
2 entries collected fixed bin (17) unaligned, /* KST entries recovered by garbage collection */ 
2 free_list bit (18) unaligned, /* relative pointer to first free kste */ 
2 prelinked_ring (7) bit (1) unaligned, /* rings prelinked in process */ 
2 template bit (14) unaligned, /* this is a template kst if set +*/ 
2 allow_286K_connect bit (1) unaligned, /* can use 256K segments */ 
2 unused _2 bit (9) unaligned, 
2 uld_hash_bucket (0 : 127) bit (18) unaligned, /* hash buckets */ 
2 kst_entry (0 refer (kst.lowseg):0 refer (kst.highseg)) aligned like kste, /* kst entries */ 
2 Iv (1:256) bit (36), /* private logical volume connection list */ 
2 end_of_kst bit (36); 
dc} 1 kste based (kstep) aligned, /* KST entry declaration +/ 
2 fp bit (18) unaligned, /* forward rel pointer */ 
2 segno fixed bin (17) unaligned, /* segment number of this kste */ 
2 usage_count (0:7) fixed bin <8) unaligned, /* outstanding initiates/ring */ 
2 entryp ptr unaligned, /* branch pointer */ 
2 uid bit (36) aligned, /* unique identifier */ 
2 access_information unaligned, 
3 dtbm btt (36), /* date time branch modified */ 
3 extended_access bit (33), /* extended access from the branch */ 
3 access bit (3), /* rew */ 
3 ex_rb (3) bit (3), /* ring brackets from branch */ 
2 hdr bit (3) unaligned, /* highest detectable ring */ 
2 flags unaligned, 
3 dirsw bit (1), /* directory switch */ 
3 allow _write bit (1), /* set if initiated with write permission */ 
3 priv_init bit (14), /* privileged initiation */ 
3 tms bit (14), /* transparent modification switch */ 
3 tus bit (1), /* transparent usage switch */ 
3 tpd bit (1), /* transparent paging device switch */ 
3 audit bit (4), /* audit switch */ 
3 explicit_deact_ok bit (1), /* set if I am willing to have a user force deactivate xf 
3 pad bit (3), 
2 Infcount fixed bin (12) unaligned; /* if dirsw itthen inferior count else Iv index */ 
nel.plt - - - - - - 2" - - - - «f 


/* END INCLUDE FILE - - - - - - - - - - - - kst.1 


include *, hard.source 
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segment in: >Idd>include contents modified: 04/14/82 1336.2 


lock_array.incl.pli 
entry modified: 04/14/82 1337.7 


/* BEGIN INCLUDE FILE ... lock_array.incl.pit */ 
/* modified BIM 2/82 to clean up */ 
/* format: styled +/ 


dcl 1 pds$lock array (0:19) external aligned like pds_entry; 
dc} 1 pds_entry based, 
2 lock.ptr pointer, 
2 event bit (36) aligned, 
2 flags aligned, 
3 dir_ltock bit (1) unaligned, /* This is a dir read lock */ 
3 one_word bit (1) unaligned, /* lock$wait */ 
3 pad bit (34) unaligned, /* else lock$lock_fast */ 
2 cailer_ptr pointer; ‘ 
/* END INCLUDE FILE ... lYock_array.incl.plt */ 
incl «.**, hard.source lock array.in  plt 
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Ivt. incl. pli segment in: >ldd>include contents modified: 11/22/76 1025.1 
entry modiffed: 03/10/82 0836.6— ! 
/* BEGIN INCLUDE FILE Ivt.incl.pl1 -- Written Jan. 1976 by R. Bratt +/ 
/* 3 , 
This include file defines the format of the hardcore Logical Volume Table (LVT). 
«/ 
del iIvt$ ext: 
dc) Ivtp ptr; 
del tvtep ptr; 
dcl 1 Ivt aligned based (Ivtp), 
2 max_Ivtex fixed bin (17), /* maximum number of LVs describable */ 
2 high_water_lIvtex fixed bin (17), /* highest LVT index assigned */ 
2 free_Ivtep ptr, /* pointer to first free lvte +*/ 
2 padi (4) bit (36), 
2 ht (0:63) ptr unal, /* lvid hash table */ 
2 Ivtes (1:1 refer (Ivt.max_lvtex)) like Ivte; /* LVT entries */ 
dc! 1 Ivte aligned based (Ivtep), /* logical volume table entry */ 
2 lvtep ptr unaligned, /* lvid hash thread */ 
2 pvtex fixed bin (17), /* thread of mounted PVs */ 
2 Ivid bit (36), /* logical volume id */ 
2 access_class aligned, /* access isolation mechanism stuff */ 
3 min bit (72), /* minimum access class allowed on LV */ 
3 max bit (72), /* maximum access class allowed on volume */ 
2 flags unaligned, /* flags */ 
3 public bit (1), /* => anyone can connect to this LV */ 
3 read_only bit (1), /* => no writes on this LV */ 
3 pad bit (16), . 
3 cycle pvtx fixed bin (17); /* pvtx for next per_process seg */ 
/* END INCLUDE FILE Ivt.incl.ptt +/ 
include «*, hard.source Ivt.inel.pli r 
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mc.incl.plit 


/* 


inc’ .**, hard.source 
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segment in: 
entry modified: 


mc.incl.pii 


>Idd> include 
03/10/82 0837.0 


contents modified: 


09/08/81 


1426.4 


ye 
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*/ 


/* BEGIN INCLUDE FILE mc.incl.plit 


/* Modif ted 06/07/76 by Greenberg for mc.resignal +*/ 
/* Modified 07/07/76 by Morris for fault register data */ 
/* Modified 08/28/80 by J. A. Bush for the DPS8/70M CVPU *+/ 


/* words 0-15 pointer registers */ 
dcl mcp ptr: 


del 1 mc based (mcp) aligned, 
2 prs (0:7) ptr, 
(2 regs, 

x (0:7) bit (18), 

a bit (36), 

q bit (36), 

e bit (8), 

padi bit (28), 

2 t bit (27), 

3 pad2 bit (6), 

3 rair bit (3), 


QWAA WwW 


scu (0:7) bit (36), 


mask bit (72), 

ips_temp bit (36), 

errcode fixed bin (35), 
fim_temp, 

3 unique_index bit (18) unal, 
' 3 resignal bit (1) unal, 

3 fcode bit (17) unal, 
fault_reg bit (36), 

pad2 bit (1), 

cpu_type fixed bin (2) unsigned, 
ext _fault_reg bit (15), 
fault_time bit (54), 


NUD A UL) 


LS) NN DN IS 


eis_info (0:7) bit (36)) unaligned; 


dci (apx fixed bin init ( 
abx fixed bin tnit ( 
bpx fixed bin init ( 
bbx fixed bin init ( 
Ipx fixed bin init ( 
Ibx fixed bin init ( 
spx fixed bin init ( 
sbx fixed bin init ( 


inctude °*, hard.source 
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tnternal static; 


mce.incl.pii 


Created Dec 72 for 6180 - WSS. */ 


POINTER REGISTERS */ 
registers */ 

index registers */ 
accumulator */ 
q-register */ 
exponent +/ 


timer register */ 


ring alarm register */ 


mem controller mask at time of fault */ 
Temporary storage for IPS info */ 
fault handler’s error code */ 


unique index for restarting faults */ 

recomputte signal name with fcode below */ 

fault code used as tndex to FIM table and SCT */ 
fault register */ 


L68 = 0, DPS8/70M = 1 */ 
extended fault reg for DOPSB/70M CPU +/ 
time of fault */ 


dc} 


dct 


/* 


scu 


p ptr; 


1 scu based (scup) aligned, 


WORD (0) 


(2 ppr, 


/* 


ing 


FBOA 
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3 
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a 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
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prr bit (3), 
psr bit (15), 
p bit (1), 


pu 
xf bit (1 


) 
sdwm bit (1 
sd_on bit ( 
ptwm bit (1 
pt_on bit ( 
pi_ap bit ( 
dsptw bit ( 
sdwnp bit ( 
{ 

) 

1 

) 

1 

1 


fanp bit 
fabs bit 


fault_cntr bit (3), 


woRD (1) 


iro bit (1) 
oeb bit (1) 
e_off bit ( 
orb bit (1) 
r_ off bit ( 
owb bit (1) 
w_off bit ( 
no_ga bit ( 
ocb bit (1) 
ocall bit ( 
boc bit (1) 
inret bit ( 
crt bit (1) 
ralr bit (1 
am_er bit ( 
oosb bit (1 
paru bit (1 
parl bit (1 
onc_i bit ( 


+/ 


+/ 


/* 


mc.incl.plt 


SCU DATA */ 


PROCEDURE POINTER REGISTER +*/ 
procedure ring register +*/ 
procedure segment register */ 
procedure privileged bit */ 


APPENDING UNIT STATUS */ 
ext seg flag - 
match in SOW Ass. Mem. +/ 


SDW Ass. Mem. ON */ 

match in PTW Ass. Mem. */ 

PTW Ass. Mem. ON */ 

Instr Fetch or Append cycle */ 
Fetch of DSPTW «/ 

Fetch of SOW non paged */ 

Fetch of SOW paged */ 

Fetch of PTW +*/ 

Fetch of pre-paged PTW */ 

Fetch of final address paged */ 
Fetch of final address non-paged */ 
Fetch of final address absolute */ 


number of retrys of EIS instructions */ 


FAULT DATA */ 
illegal ring order */ 


out of execute bracket */ 


no execute */ 

out of read bracket */ 
no read */ 

out of write bracket «/ 
no write */ 

not a gate *+/ 

out of call bracket */ 
outward call */ 

bad outward call */ 
inward return */ 

cross ring transfer */ 
ring alarm register */ 


associative memory fault */ 


out of segment bounds +*/ 


processor parity upper +*/ 
processor parity lower */ 
op not complete type 


IT modification */ 


1 +/ 


“age 


'48 


/* 


/* 


3 onc_2 bit (1), 


port_stat, 

3 fal bit (4), 

3 fac bit (3), 

3 con_chan bit (3), 


fi_num bit (5), 
fi_flag bit (1), 

WORD (2) «/ 
tpr, | 
3 trr bit (3), 

3 tsr bit (15), 
pad2 bit (9), 

cpu_no bit (3), 
delta bit (6), 


WORD (3) */ 
word3 bit (18), 


tsr_stat, 

3 tsna, 
4prn bit ( 
4prv bit ( 

3 tsnb, 
4prn bit ( 
4prv bit ( 

3 tsnc, 
4prn bit ( 
4 prv bit ( 

( 


tpr_tbr bit 


WORD (4) */ 


fle bit (18), 


= 
3 


| 
) 
carry bit ( 
ovfl bit (4 
eovf bit (1 
euf!) bit (14 
ofim bit (1 
tro bit (1) 


QWOW WO & 


fnclude *, hard.source 


F8OA 


lot to be reproduced 


/* 
/* 


mce.incl.plit 


op not complete type 2 +*/ 


PORT STATUS */ 

illegal action lines +*/ 
f{ltegal action channel +*/ 
connect channel */ 


(fault/interrupt) number +*/ 
1 => fault, O => interrupt 


TEMPORARY POINTER REGISTER */ 


temporary ring register +*/ 


tamporary segment register */ 


CPU number */ 


tally modification DELTA «/ 


TSR STATUS for 1,2,&3 word instructions */ 


Word 1? status */ 

Word 1 PR number */ 
Word 1 PR valid bit */ 
Word 2. status */ 

Word 2 PR number */ 
Word 2 PR valid bit */ 
Word 3 status */ 

Word 3. PF number */ 
Word 3 PR vatid bit */ 
TPR.TBR field */ 


INSTRUCTION COUNTER */ 


INDICATOR REGISTERS */ 
zero indicator */ 
negative indicator +*/ 
carryry tndicator +*/ 
overflow indicator */ 
eponent overflow */ 
exponent underflow */ 
overflow mask */ 

tally runout */ 


+/ 


nett te nt ih rN 


3 par bit (1), /* parity error +/ 
3 parm bit (1), /* parity mask +*/ 
3 bm bit (1), /* “bar mode «/ 
3 tru bit (1), /* truncation mode */ 
3mif bit (4), /* multi-word instructton mode */ 
3 abs bit (1), ; /* absolute mode */ 
3 pad bit (4), 
/* wORD (5) «/ ° 
2 ca bit (18), /* COMPUTED ADDRESS */ 
2 cu, /* CONTROL UNIT STATUS */ 
3 rf bit (14), /* on first cycle of repeat instr */ 
3 rpt bit (1), /* repeat instruction */ 
3rd bit (1), /* repeat double instruction */ 
3r) bit (1), /* repeat link instruciton */ 
3 pot bit (1), /* IT modification */ 
3 pon bit (1), /* return type instruction */ 
3 xde bit (1), /* XDE from Even location */ 
3 xdo bit (1), /* XDE from Odd location */ 
3 poa bit (14), /* operation preparation */ 
3rfi bit (1), /* tells CPU to refetch instruction */ 
3 its bit (1), /* ITS modification */ 
3 if bit (14), /* fault occured during instruction fetch */ 
2 cpu_tag bit (6)) unaligned, /* computed tag field */ 
/* ‘WORDS (6,7) */ 
2 even_inst bit (36), /* aven instruction of faulting pair */ 
2 odd_inst bit (36); /* odd instruction of faulting pair */ 
/* ALTERNATE SCU DECLARATION «/ 


dcl 1 scux based (scup) aligned, 


(2 padoO bit (36), 


2 fd, /* GROUP IIT FAULT DATA */ 
3 isn bit (1), /* illegal segment number +*/ 
3 ioc bit (1), . /* illegal op code */ 
3 ja_am bit (1), /* illegal address - modifier */ 
3 isp bit (14), : /* iltegal siave procedure */ 
3 ipr bit (1), /* iltegal procedure */ 
3 nea bit (14), /* non existent address */ 

incl **, hard. source mc. incl.pli1 


F8OA - Not to be reproduced 


/* 


3 oobb bit (1), 
3 pad bit (29), 


2 pad2 bit (36), 
2 pad3a bit (18), 
2 tsr_stat (0:2), 
3 prn bit (3), 
3 prv bit (14), 
2 pad3b bit (6)) unaligned, 
2 pad4sS (0:1) bit (36), 


2 instr (0:1) bit (36); 


END INCLUDE FILE mc. incl.pli */ 


include «*, hard.source 


F8O; 


swt to be reproduced 


/* 


/* 


mc.incl.plt 


out of bounds +*/ 


TSR STATUS as an ARRAY */ 
PR number *«/ 
PR valid bit */ 


Instruction ARRAY +*/ 


i nn eee ea Sn at sp te mannii ronnie 


null_addresses. inc).piit - segment in: >dd>incltude contents modifted: 


entry modifted: 10/13/82 1311.9 


10/13/82 


ernie nents master Ahtisaari nner thresh NR rent ere eer iene tenet en ip nA ep tt enn 


/* BEGIN INCLUDE FILE null_addresses.incl.pl1 */ 


dc! (pc_move_page_table_1_null_addr init 
pc_move_page_table_2_ null_addr init 
get_aste_null_addr init 
make_sdw_null_addr init 
put_aste null_addr init 
page_bad_pd_null_addr init 
Tist_deposit_null_addr init 
get_file_map_null_addr init 
fill _page_table null_addr init 
init_sst_null_addr init 
get_file_map_vt_null_addr init 
unprotected_null_addr init 
page_parity_null_addr init 
page_devparity_null_addr init 
get_file_map_dumper_non_null_addr init 
page_bad_nul!_addr init 
page_problem_nultl_addr init 


("3770070"b3), 
("3770100"b3), 
("3770110"b3), 
("3770120"b3), 
("3770130"b3), 
("3770150"b3), 
("3770160"b3), 
("3770170"b3), 
("3770200"b3), 
(°3770210"b3), - 
("37.70220"b3), 
("3770230"b3), 
("3770260"b3), 
("3770270"b3), - 
("3777720"b3), 
("3770240"b3), 
("3770250"b3)) bit (22) aligned static options (constant); 


dc! create _vtoce_four_null_addrs fixed bin (71) int static init (-1)3/* 777777 777777 777777 «777777 */ 


dc! (create_vtoce_null_addr init 
update_vtoce_null_addr init 
truncate_vtoce_fill_null_addr init 
truncate_vtoce null_addr init 
pv_salv_nuili_addr init 
pv_scav_null_addr init 

* volume_reloader_null_addr init 

volume_retriever_null_addr init 
salv_truncate_null_addr init 


/* END INCLUDE FILE null_addresses.incl.plt +*/ 


tinct .**, hard.source 


F8OA - Not to be reproduced 


€"°777777"b3), 

("777776"b3), 

("777775"b3), 

("777002"b3), 

("*777004"b3), 

("777006"b3), 

(°777774"b3), 

(°777773"b3), . ae 
("777005"b3)) bit (18) aligned static options: (constant); 


null addresse ict. pit 


1310.8 


- 52 


pds.cds segment in: >Idd>hard>source — system id: 
contents modified: 03/14/83 1653.3 entry modified: 
/* ee eRe iter ake ete hae genie RC ai fe ie ake ie eae ai a kk kk ok 


/* 


*/ 


/* 


/* 


* = * 
* Copyright, (C) Honeywell Information Systems Inc., 1982 * 
* * 
JOR IOIOIOIGISIOI I IOIGIOIOIOIOIOIOIOIOR NGI ROTOR OI IOIOIOINIOIOR III IIOI doi ii oto iototoioiotogaa 4 7 


PDS - The Process Data Segment 


Last modified (Date and reason): 
2/6/76 by §. Webber Initial coding 
9/17/76 by R. Bratt to add seg fault, bounds_fault, 
11/03/76 by M. Weaver to extend stack header 
04/20/77 by M. Weaver to delete rntp and 7/77 to add name template_pd3 
06/07/78 by E. Donner to add ring_events (to prevent delayed ipe wakeups) 
05/10/79 by B. Margulies to eliminate exmode_level 
05/09/79 by Mike Grady to use shared ring O stacks 
08/17/79 by J. A. Bush for exp under/overflow restart switches & cache parity diagnostics 
02/28/80 by 8. Margulies to use the include file for the default overflow 
08/26/80 by J. A. Bush for the DPS8/70M CPU 
value. 
02/23/81 by J. Bongiovanni to remove temp_mode_reg (moved to prds$moda_reg_enabled) 
03/81 by E. Donner to remove next_{itt and ect _pointers 
3/82 BIM for lock_array cleanup. 
11/82 by J. Bongiovanni to make force_write_limit per-ring 
2/83 by E. N. Kittlitz for hfp_exponent_enabied. 


vtoc_read, and vtoc_write meters. 


Lhe e ee RSE EEE EERE EERE SEE RSE SEER ERE EES EES E RES RS RES ESE ES 
* * 
mm * 
* Copyright (c) 1972 by Massachusetts Institute of * 
* Technology and Honeywell Information Systems, Inc. * 
ve * 
* * 
[REESE ESE LESSEE ES EEE ES ES ERE SESE SER ER EERE RSE SS RES ES ESE 


*/ 


format: style3,idind25 */ 


pds: 


/* 


proc; 


This program creates the pds data base */ 


/* Automatic */ 

dc! 1 cdsa aligned like cds_args; 
dc} code fixed bin (35); 

ine lude *, hard.source pds.cds 
Fs80l ss jot_ to be reproduced : 


37-20 
03/27/83 


1807.2 


/* Constants */ 


deci pdsname 
dc} exclude_pad 


/* Buittins */ 


dc} (addr, bin, bit, hbound, 


/* Entries +/ 


dcl com_err_ 

dcl create _data_segment_ 
dcl _ get_temp_segment_, 

dcl release_temp_segment_ 
dc} hcs_$chname_file 

dc}! get_wdir_ 


/* External Static */ 


del error_table_$segnamedup 


inc’ -**, hard.source 


F8OA - Not to be reproduced 


char (3) aligned static init ("pds") options (constant); 
(4) char (32) aligned static options (constant) init ("pad*"); 


mod, null, rel, size, string, unspec) 
builtin; 


entry options (variable); 

entry (ptr, fixed bin (35)); 

entry (char (+), ptr, fixed bin (35)); 

entry (char (*), ptr, fixed bin (35)); 

entry (char (*), char (*), char (*), char (*), fixed bin (35)); 
entry () returns (char (168)); 


fixed bin (35) ext; 


pds.cds 


1e 


84 


dct pdsp 


dcl 1 pds 


NNN HNN NMVNUPNUNPNNRNNANNAHNAH NNOENAOANANNANAN AN NN NN A AD PO A 


page_fault_data. 
fim_data 

Signal data 
history_reg data 
process_group_id 
cpu_time 


virtual delta 


ptr; 


aligned based (pdsp), 


like mc, 
Tltke mc, 
aligned like mc, 


(64) fixed bin (71), 


char (32), 
fixed bin (52), 


fixed bin (52), 


virtual _time_at_eligibility 


temp_1 
temp_2 
time_1 
time_v_temp 
fim_v_temp 
fim_v_deltta 


save_history_regs 


hregs_saved 
Tast_sp 
apt_ptr 
arg_1 

arg 2 

arg_3 

arg_4 


access_authoritzation 


base_addr_reg 
alarm_ring 


pxss_args_invalid 


process id 
process_id 
vtime_count 
pstep 

dstep 
wakeup _flag 
pc_call 
audit _flags" 
quota_inhib 
pd_page_faults 
page waits 


fixed bin (52), 
fixed bin (71), 
fixed bin (71), 
fixed bin (52), 
fixed bin (52), 
fixed bin (52), 
fixed bin (771), 
bit (1) aligned, 
bit (1) aligned, 
ptr, 

ptr, 

fixed bin (71), - 
fixed bin (71), 
fixed bin (71), 
fixed bin (71), 


aligned like aim_template, 


bit (18) aligned, 


fixed bin (3), 


bit (36) aligned, 
bit (0) unaligned, 
bit (36) aligned, 


fixed bin, 


bit (0) unaligned, 
bit (18) aligned, 
bit (36) aligned, 
bit (36) aligned, 
bit (36) aligned, 
bit (36) aligned, 


fixed bin, 
fixed bin, 


number_of_pages_in_use 


post_purged 
connect_pending 
segment faults 
bounds_faults 
vtoc_reads 
vtoc_writes 
mc_trace_seg 
mc_trace_sw 


include *, hard.source 


F&O; vot to be reproduced 


fixed bin, 
fixed bin, 
bit (1): aligned, 
fixed bin (35), 
fixed bin (35), 
fixed bin (35), 
fixed bin (35), 
fixed bin, 
bit (2) aligned, 


pds .cds 


MC for page faults and timer runouts */ 

MC for normal faults */ 

storage for MC being signalled +/ 

this must follow signal data */ 

user id for current process */ _ 

number that when subtracted from clock reading gives 
virtual cpu time */ 

temporary used in calculating VCPU time */ 


temporary used in calculation of VCPU time */ 
temporary */ 

temporary +*/ 

page fault metering time +*/ 

temporary used in calculating VCPU time */ 
VCPU temporary for the FIM */ 

VCPU temporary for the FIM */ 

= "{"b if history registers are to be saved */ 
= “{"b {tf history regs were saved */ 

stack pointer at getwork time */ 

pointer to this process: 8 APT entry */ 
argument for pxss 

argument for pxss a 

argument for pxss */ 

argument for pxss */ 


access authorization for the process */ 
for BAR mode use */ 

setting for ring alarm register */ 

used by pxss masking/arg copying code */ 
process ID (added segdef) */ 

process ID */ 

depth counter used in VCPU calculation */ 
(added sagdef for dstep) */ 

rel pointer to ASTE for dseg */ 

flag indicating type of wakeup */ 

flag saying type of wait */ 

bits indicating types of auditing to do */ 
ON If quota checking to be Inhibited */ 
faults from paging device */ 

page faults */ 


used in calculating memory units */ 

number of post purgings */ _ 

turned on for delayed connects to be resent by fim */ 
count of segment faults taken by this process */ 
count of bounds faults taken by this process */ 

vtoc read I/Os done for this process */ 

vtoc write I/Os done for thts process */ 

seg number of object segment being traced */ 

switch for M. C. Tracing “ft f"b => trace on */ 


Page 
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inc’ 


re i 


BRM MN BDH DD ND OB RN NR BD i NM RD RD BS 1 IS NS RS A 


RON RN BR 


OBB HAR Dh 


stack_0O sdwp 
stack_0O ptr 
tc_argp 
tc_mask 
exp_undfl_ rest 
exp_ovfl_ rest 
eovfl_ value 
cpar_err_data 
cpar_mem_data 
cpar_info 


hfp_exponent_enabled 
pad_for_trace_mod16 


trace 


timer_titme_out 
timer_channel 
term_channel 
term_proc 
pli_machine 
validation_level 
condition_name 

3 len 

3 chars 
pad_obsolete 
ips_mask 
auto_mask 
ring_alarm_val 
lock_id 
mco_trace_buf 
pad_end_of_page_O 
pathname_am 
initial_procedure 
account_id 
lock_array 
access _ name 

3 user 

3 project 

3 tag 

home_dir 
process_dir_name 
wdir 

wdir_uid 
transparent 

itt _head 


ptr aligned, 


ptr aligned, 


ptr, 

bit (72) aligned, 
bit (1) aligned, 
bit (1) aligned, 
bit (72) aligned, 
bit (72) aligned, 
bit (72) aligned, 
bit (36) alitgned, 
bit (1) aligned, 


(14) fixed bin, 
(306) fixed bin (71), 


fixed bin (52), 
fixed bin (71), 
fixed bin (71), 
bit (36) aligned, 
fixed bin, 

fixed bin (3), 
aligned, 


fixed bin (8) unaligned, 


char (31) unaligned, 
bit (36) aligned, 

(0:7) bit (35) aligned, 
(0:7) bit (36) aligned, 
(0:7) fixed bin, 

bit (36) aligned, 

ptr unaligned, 

bit (0) unaligned, 
aligned like pam, 

ptr, 

char (32) aligned, 


ptr to stack sdw in dseg */ 

ptr to base of ring O stack (wired for esd) */ 

arg ptr used by tc */ 

save tc mask +*/ 

switch for restarting. exp underflows from the fim +/ 
switch for restarting exp overflows from the fim */ 
value to load. when restarting exp overflows from the fim */ 
cache parity error data (from cache) */ 

cache parity error data (from memory) «/ 

diagnose flag, cache ltevel and absaddr # */ 

user allowed to set IR hex exp bit */ 


system trace data */ 

pds$trace + 16 defines the pds for idle procs */ 
time out time for the process */ 

event channel for time out event */ 

channel used to signal process termination */ 
process ID of process to signal term process +*/ 
nonzero if we do pli-like things */ 


ACC string for condition name */ 


IPS masks */ 

array of automatic masks for IPS signals */ 
used in checking validation level changes */ 
UID used in some locking */ 

packed ptr to mc_trace wired buffer */— 


pathname associative memory +*/ 
first procedure executed in a new process */ 
not used yet */ 


(0:19) aligned like pds_entry, 


aligned, 

char (32) aligned, 

char (32) aligned, 

char (32) aligned, 

char (168) aligned, 
char (32) aligned, 
(0:7) ptr, 

(0:7) bit (36) aligned, 
bit (36) aligned, 

bit (18) aligned, 


max_access authorization 


stacks 

kstp 

events pending 
speciat_channels 
event_masks 
initial ring 
interrupt_ring 
highest_ring 


hard. source 


FB8OA - Not to be reproduced 


aligned like aim _template, 


(0:7) ptr, 

ptr, 

bit (36) aligned, 

bit (36) aligned, 

(7) bit (36) aligned, 
fixed bin (3), 

fixed bin (3), 

fixed bin (3), 


pds.cds 


/* 


/* 
/* 
/* 
/* 
/* 
/* 


alternate form of process group id */ 


home directory */ 

name of process directory at 

pointers to per-ring working directories */ 
UID of per-ring working directories */ 
transparent usage, mod, pd switch */ 

top of present ITT list */ 


max authorization this user can attain */ 
per-ring stack pointers +/ 

pointer to start of -KST */ 

special wakeups -pending */ 

special channels assigned */ 

per-ring mask for special channels */ 

initial ring of execution for the process */ 
lowest ring in which IPS interrupts are allowed */ 
highest ring in which process can run */ 


thy 
oO 
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2 prelinked_ring bit (8) aligned, /* bit(i) is ON if ring (1) .is prelinked */ 
2 unique_scu_index bit (36) aligned, /* used to tag MC */ 
2 max_lot_size (0:7) fixed bin, /* sizes lots can grow to */ 
2 lot_stack_size (0:7) fixed bin, /* size of lot in stack (O -> lot not in stack) */ 
2 clr_stack_size (0:7) fixed bin, /* size of CLR in stack +/ 
2 network _ptbl_tdx fixed bin, /* index intc NCP’s process table */ 
2 link_meters_bins (4) fixed bin, /* histograms of linkage faults */ 
2 link_meters_times (4) fixed bin (30), /* histogram of linkage fault times */ 
2 Vink_meters_pgwaits (4) fixed bin, /* histogram of linkage faults PF’s */ 
2 dmpr_copy_dirsegp ptr, — /* ptr to temp segment into which dirs are copied */ 
2 dmpr_pvid bit (96), /* pvid of volume being dumped */ 
2 dmpr_pvtx fixed bin, /* pvtx of volume being dumped */ 
2 first_call fixed bin, /* ON until leave ring zero once +*/ 
2 mc_save_area bit (18) aligned, . /* rel pointer to start of saved MC area */ 
2 mc_save_ptr bit (18) aligned, /* ptr to next mc save place */ 
2 mc_save_ limit bit (18) aligned, /* max address where MC can be saved */ 
2 useable lot bit (8) aligned, /* indicates whether lot can be referenced */ 
2 ring_events bit (36) aligned, /* per-ring indicator that itt messages copied to ect */ 
2 force_write_limit (0:7) 
fixed bin, /* limit on ftorce-writing */ 
/* Following must be doubleword aligned! */ 
2 ipc_vars aligned, /* holds state of fast_hc_ipc at block */ 
3 ap pointer unal, 
3 retsw fixed bin (35), 
3 save_entry_ret fixed bin (35), . 
3 truncated_stacks fixed bin (35), 
3 chan fixed bin (71), 
3 block_start_steps fixed bin (35), 
3 stk_temp fixed bin (35), 
2 ipe_block_return bit (36), /* ipe block return address */ 
2 avg _block_steps fixed bin (35, 18), : 
2 block  tock_count fixed bin, /* count of jocks held */' 
2 pad_for_data_modi6 (13) fixed bin (35), 
2 data bit (0) aligned; /* to mark end of PDS for MC save area */ 


%include pathname_am; 
%include exponent_control_info; 
%include lock_array; 


include 


F8OA 


*, hard. source 


jot to be reproduced 


pds.cds 


call get_temp_segment_ (“pds", pdsp, code); 
/* Now begins the initialization */ 
pds.process group_id = "Initializer.SysDaemon.z"; 


pds.access_authortzation.categories = (18)"0O"b; 
pds.access_authorization.tevel = 0; 

pds.access_authorization.dir = “1"b; /* for initializer +*/ 
pds.access_authorization.seg = “1"b; 

pds.access authorization.rcp = "“1"b; 

pds.access authorization.ipe = "1"b; 

pds.access authorization.soos = "1"b; i rae f 


pds .max_access_authorization.categories = (18)"1"b |! (18)"O"b; 
pds.max_access_authorization. level = 7; 


pds.vtime_count = -1; 
pds.process_id = (36)"1"b; 
pds.lock_id = (36)"1"b; 
pds.plt_machine = 1; 

pds.ips_ mask (*) = (35)"1"b; 
pds.force_write_limit (*) = 1; 


pds.save_history_regs, pds.hregs_saved.= "O"b; 
pds.history_reg data (*) = O; 


pds.mc_trace_buf = null; 
pds.mc_trace_sw = “O"b; 
pds.mc_trace_seg = 0; 


pds.eovfl_value = unspec (Default_exponent_control_overflow_value); 
/7* set default exp overflow restart value */ 
pds.exp ovfl_rest, pds.exp_undfl_rest = °O"b; 


pds.stack_O sdwp = null; 
pds.stack_O ptr = null; 
pds.pad_for_trace_modi6 (*) = 0; 


trace_ptr = addr (pds. trace); 
trace. last_available = divide (hbound (pds.trace, 1) * size (page _trace_entry) - 8, 2, 17, O); 


pds.initial procedure = null; 
pds.lock_array (*).lock_ptr = null; 
pds.lock_array (*).caller_ptr = null; 
pds.lock_array (*).event = ""b; 


pds.access_name.user = “Initializer"; 

pds.access_name.project = "SysDaemon"; 

pds.access_name.tag = “z"; 

pds.home_dir = ">system_control_1"; 

pds.process_dir_name = ">process_dir_dir>!zzzzzzzbBBBBBB" ; 
inc Je.**, hard.source pds .cds 


F8OA - Not to be reproduced 


pds.wdir (*) = null; 
pds.wdir_uid (*) = "O"b; 


pds.stacks (*) = null; 


pds.dmpr_pvid = “O"b; 
pds.dmpr_pvtx = 0; 
pds.dmpr_copy_dirsegp = null; 


pds.kstp = null; 
pds.first_call = 1; 
pds.initial_ ring = 1; 
pds. interrupt_ring = 4; 
pds. .highest_ring = 7; 


pds.max_lot_size (*) = 1024; 


pds.mc_save_area = rel (addr (pds.data)); 
pds.mc_save_ptr = rel (addr (pds.data)); 
pds.mc_save_limit = bit (bin (4096, 18), 18); /* Allow for as many as fit in 4K. */ 


/* Now make some checks on alignment of certain variables */ 


call check (addr (pds.ipc_vars), “ipc_vars", 2); 

call check (addr (pds.page_fault_data), “page fault_data", 16); 
call check (addr (pds.trace), “trace”, 16); 

call check (addr (pds.signal_data), "signal_data", 16); 

call check (addr (pds.lock_array), “lock_array", 2); 

call check (addr (pds.data), “data"“, 16); 

if bin (rel (addr (pds.pad_end_of_page_0O)), 18) *= 1024 

then call com_err_ (0, pdsname, “Wired portion must end at 1024"); 


/* Now set up call to create data base */ 
cdsa.sections (1).p = addr (pds); 
cdsa.sections (1).len = size (pds); 
cdsa.sections (1).struct_name = "pds"; 
cdsa.seg name = "pds"; 
cdsa.num_exclude_names = 1; 
cdsa.exclude_array_ptr = addr (exclude_pad); 


string (cdsa.switches) = "O"b: 
cdsa.switches.have_text = "1"b; 


call create _data_segment_ (addr (cdsa), code); 
call release_temp_segment_ ("pds", pdsp, code); 
call hes_$chname_file (get_wdir_ (), "pds", ““, “template_pds", code); 


if code “= 0 
then if code “= error_table_$segnamedup 


ct ei 


include +*, hard.source pds.cds FP -7Ja 59 


F8OA wt to be reproduced 


then call com_err_ (code, pdsname, “Unable to add name template_pds."); 


inc? .**, hard.source pds.cds 


F8OA - Not to be reproduced 


ye 
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check: 


proc (where, message, modulo); 


dc} 
dc} 
dc} 
dcl 


where ptr: 

message char (*); 
modulo fixed bin: 
remainder fixed bin; 


remainder = mod (bin (rel (where), 18), modulo); 


if remainder “= O 
then call com_err_ (0, pdsname, 


“The vartable “a is “d words away from being 


message, (modulo - remainder), modulo); 


end check; 


includ 


F8OA 


*, hard. source 


10t to be reproduced 


pds .cds 


aligned on a “d-word boundary.", 
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%include cds_args; 


inc ».**, hard.source pds.cds 
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%include sys_trace; 
%inctude aim_template; 


%include mc; 


end pds; 


includ: *, hard. source 
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prds.cds segment in: >Idd>hard>source 
contents modified: 07/29/81 1816.2 


renter esncemrmen enema tmamve inert rt reer frente soneaseasearesetntntantte overt s tvnanentn sterner f eran te snes en here rn ee hn I AS 


/* PROS - The Processor Data Segment and Processor Stack. 
/* Last modified (Date and reason): 
2/6/76 by S. Webber Initial coding 
6/15/77 by M. Weaver to null signal and sct pointers 
8/25/80 by J. A. Bush for the dps8/70m cpu 
2/22/81 by J. Bongiovanni for fast_connect_code 
6/27/81 by J. Bongiovanni for idle_temp 

+ / 


/* WOR ORO ORO ROR OIRO ROR OR ROR IORI AOR OR HORROR IOI; ORB HOR HORROR gg OR Ok itt 


* 

™ 

* Copyright (c) 1972 by Massachusetts Institute of 

* Technology and Honeywell Information Systems, Inc. 
* 
* 
* 


+e & & & 


* 
ER ERE EES ESE SRE SEE ES ERE SE SES EERE REE ERE SES SESE SS SSE ESS af 


prds: proc; 

/* This program creates the prds data base */ 
/* Automatic */ 

dct i fixed bin; 

dcl 1 cdsa aligned like cds_args; 

dc)l code fixed bin (35); 

/* Static */ 


del prdsname char (4) aligned static init (“prds“) options (constant); 
deci exclude pad (1) char (32) aligned static options (constant) init ("“pad*"); 


/* The following must correspond to the size of the fast connect code in 
fast_connect_init 


dct FAST_CONNECT_CODE_WORDS init (62) fixed bin int static options (constant); 
/* Builtins */ . 

dc} (addr, baseptr, bin, mod, null, ptr, rel, size, string, unspec) builtin; 

/* Entries */ | 

dc! com_err_ entry options (variable); 


dc! create_data_segment_ entry (ptr, fixed bin (35)); 
dc! get_temp_segment_ entry (char (*), ptr, fixed bin (35)); 


ince 3.**, hard.source prds.cds 
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system id: 
entry modif led: 


36-1 
03/27/83 


1807. 1 


ae 


64 


dcl release _temp_segment_ entry (char (*), ptr, fixed bin (35)); 


includ: -*, hard. source prds.cds Page 65 
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dci prdsp ptr; 


del 1 prds aligned based (prdsp), 
2 header aligned like stack_header, : /* standard stack header +/ 
2 interrupt_data aligned like mc, /* MG for interrupts */ 
2 fim_data aligned like mc, : /* MC for connect faults, timer runouts */ 
2 sys_trouble data aligned like mc, /* MC for saved sys trouble data */ 
2 ignore data aligned like scu, /* for SCU data to be ignored at certain times »*/ 
2 iitemp fixed bin (71), /* temporary used by ti (surprise!) */ 
2 last_recorded_time fixed bin (71), /* used by traffic control «/ 
2 idie ptr ptr, /* pointer to idle process APTE for this processor */ 
2 simulated_mask fixed bin (71), /* simulated system controtler mask register */ 
2 am_data bit (0), ; /* to get addr of associative memory data block */ 
2 ptw_am_regs (416) fixed bin (35), /* page table regs (4 sets of 16 for dps8/70m) */ 
2 ptw_am_ptrs (4+*16) fixed bin (35), /* page table pointers (4 sets of 16 for dps8/70m) */ 
2 sdw_am_regs (4%*16) fixed bin (71), /* segment desc. regs (4 sets of 16 for dps8/70m) */ 
2 sdw_am_ ptrs (416) fixed bin (35), /* segment desc. pointers (4 sets of 16 for dps8/70m) */ 
2 processor pattern bit (8) aligned, /* 1 bit ON for this processor */ 
2 processor_tag fixed bin (3), /* CPU tag from maintenance panel */ 
2 last_timer_setting bit (27) aligned, /* last timer value loaded for this CPU */ 
2 depth fixed bin, /* depth in eligible queue for running process */ 
2 mode_reg bit (36) aligned, /* mode register for this processor +*/ 
2 cache_luf_reg bit (36) aligned, /* cache mode register for this CPU +*/ 
2 fault_reg bit (72) aligned, /* place to store the fault register */ 
2 apt_ptr ptr, : /* -> apte running on this cpu */ 
2 idle_temp fixed bin (71), /* used by idle process */ 
/* The following contains code used for handling connect faults for this processor | */ 
2 fast_connect_code (FAST_CONNECT_CODE_WORDS) bit (36) aligned, 
2 fast_connect_code_end bit (36) aligned, /* marker for fast_connect_init */ 
2 mode_reg enabled bit (36) aligned, /* used to set mode register «/ 
2 pad_mod_16 (3) fixed bin, 
2 processor_stack aligned like stack_frame; /* first stack frame location */ 
ine’ **, hard. source prds.cds 
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call get_temp_segment_ ("“prds", prdsp, code): 


unspec (prds) = ""“b; 


/* Now make some checks on alignmerit of certain variables */ 


call check (addr (prds.idie ptr), "“idie ptr", 2); 

call check (addr (prds.processor_stack), “processor_stack", 16); 
call check (addr (prds.ptw_am_regs), "“ptw_am_regs", 16); 

call check (addr (prds.sdw_am_regs), “sdw_am_regs", 32); 

call check (addr (prds.fast_connect_code), "fast_connect_code", 2); 


/* Now set up call to create data base */ 
cdsa.sections (1).p = addr (prds); 
cdsa.sections (1).ten = size (prds); 
cdsa.sections (1).struct_name = "“prds"; 
cdsa.seg_ name = “prds"; 
cdsa.num_exclude_names = 1; 
cdsa.exclude_array_ptr = addr (exclude_pad); 


string (cdsa.switches) = “O"b; 
cdsa.switches.have_text = “1"b; 


call create_data_segment_ (addr (cdsa), code); 


call release_temp_segment_ (“prds", prdsp, code); 


inclue ‘*, hard. source . prds.cds ‘ge 67 
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check: proc (where, message, modulo); 


dc! where ptr; 
dct message char (*); 
dct modulo fixed bin; 


if mod (bin (rel (where), 18), modulo) *= 0 


then call com_err_ (0, prdsname, 


end check; 


inc, 2.**, hard. source 
as ° 
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“The variable “a is not aligned on a “d-word boundary.", message, modulo); 


prds.cds 


ge 


68 


% include cds_args; 


ine lud- 


FBO; 


*, hard.source . 
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% include stack_header; 


include.**, hard.source ee prds.cds. — * ; Page 70 
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% include stack frame; 


% include mc; 


end prds; 


enc renee Ne pn ih A sn nn 


includ *, hard. source prds.cds 
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ptw.168. incl.plt segment in: 31dd>include contents modified: 07/29/81 . 1747.9 
entry modified: 03/10/82 0836.9 


/* BEGIN INCLUDE FILE ... ptw.168.incl.plt ... 02/26/81, for ADP conversion «/ 


/* Note; This tnclude file has an ALM counterpart made with cif. Keep it up to date */ 
dc! 1 168 core_ptw aligned based (ptp), /* In-core page descriptor */ 
2 frame fixed bin (14) unsigned unaligned, /* Core frame number */ 
2 padi bit (4) unaligned, 
2 flags unaligned like 168 ptw_flags; 
dcl 1 168 ptw aligned based (ptp), ‘/* General declaration for out-of-core PTW */ 
2 add bit (18) unaligned, 
2 flags like 168 ptw_flags unaligned; 
dc! 1 168 special _ptw aligned based (ptp) like 168 ptw; /* Page is somewhere peculiar -- add_type = “O1t"“b */ 
dcl 1 168 real_disk_ptw aligned based (ptp) like 168 ptw; /* PTW for page actually on disk -- add_type = “10"b */ 
dcl 1 168_null_disk_ptw aligned based (ptp) like 168 ptw; /* PTW for page not yet on disk -- add_type = “11%"b +/ 
dcl 1 168 ptw_flags unaligned based, /* Various software/hardware flags */ 
(2 add_type bit (4), /* 0000=nul}, 1000=core, 0100=disk, 0010=pd, O001*swap */ 
2 first bit (1), : /* the page has not yet been written out */ 
2 er bit (1), /* error on last page I/0 (also used by post-purge as temp) */ 
2 padi bit (1), ; 
2 unusable bit (1), /* can’t be used because hardware resets this bit «/ 
2 phu bit (1), /* page has been used bit */ 
2 phmt bit (1), /* Cumulative OR of hardware phm’s */ 
2 nypd bit (1), /* must be moved to paging device */ 
2 phm bit (4), /* page has been modified bit */ 
2 phut bit 1), /* page has been used in the quantum */ 
2 wired bit (1), /* page is to remain in core */ 
2 os bit (1), /* page is out-of-service (1/0 in progress) */ 
2 valid bit (1), /* directed fault if this is O (page not in core) */ 
2 df_no bit (2)) unaligned; /* directed fault number for. page fau)ts */ 
/7* END INCLUDE FILE ... ptw.168.incl.pli */ 


include. **, hard.source ptw.168.inci.pltt Page 72 
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pv_holdt.incl.plt 


segment in: >Idd>include 
entry modified: 03/10/82 0836.5 


/* BEGIN INCLUDE FILE ... pv_holdt.incl!.pli ... */ 


dcl pv_holdtp ptr; 


dcl 1 pv_hotdt (1 


64) based (pv_holdtp) aligned, 


2 pvtx fixed bin(17) unaligned, 
2 apterp bit(18) unaligned; 


/* END INCLUDE FILE ... pv_holdt.incl.plt ve 


include “*, hard.source pv_holdt.incl.r°' 
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pvt.incl.pli segment in: >Idd>include contents modified: 05/20/82 1037.6 
entry modified: 05/20/82 1047.6 
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/* BEGIN INCLUDE FILE ... pvt.incl.plt ... last modified January 1982. «/ 


/* The physical volume table (PVT) ts a wired-down table. 
It has one entry for each spindle present, be it for 
Storage System or “I/Q" use. 


+/ 
dcl pvt$ ext, 
pvtp ptr; 
dc} 1 pvt based (pvtp) aligned, 
2 n_entries fixed bin (17), /* number of PVT entrtes *+*/ 
2 max_n_entries fixed bin (17), ‘/* max number of PVT entries */ 
2 n_in_use fixed bin (17), : /* number of PVT entries in use */ 
2 rwun_pvtx fixed bin, /* rewind_unloading pvtx +/ 
2 shutdown_state fixed bin, /* state of previous shutdawn */ 
2 esd_state fixed bin, /* state of ESO, >O iff in ESD */ 
2 prev_shutdown_state fixed bin, /* shutdown state of previous bootload */ 
2 prev_esd_ state fixed bin, /* ESD state of previous bootload */ 
2 time_of_bootload fixed bin (71), /* Time of bootload +*/ , 
2 root_lvid bit (36) aligned, /* Logical volume ID of Root Logical Volume (RLV) */ 
2 root_pvid bit (36) aligned, /* Physical volume ID of Root Physical Volume (RPV) */ 
2 root_pvtx fixed bin, _ /* Index to PVTE for Root Physical Volume (RPV) */ 
2 root_vtocx _ fixed bin, /* VTOCE index for root (>) */ 
2 disk_table_ vtocx fixed bin, /* VTOCE index for disk table on RPV +*/ 
2 disk_table_uid bit (36) aligned, _ /* File System UID for disk_table */ 
2 rpvs_requested bit (t) aligned, /* RPVS keyword given on BOOT */ 
2 rpv_needs_salv bit (1) aligned, /* RPV required (not requested) salvage */ 
2 rlv_needs_salv bit (1) aligned, /* RLV required (not requested) salvage +/ 
2 volmap_lock_wait_constant bit (36) aligned,/* For constructing wait event: OR pvte_rel into lower +*/ 
2 volmap_idle_wait_constant bit (36) aligned,/* For constructing wait event: OR pvte_rel into lower +*/° 
2 vtoc_map_lock_wait_constant bit (36) aligned, /* For constructing wait event: OR pvte_rel into lower */ 
2 n_volmap_locks_held fixed bin (17), /* Current number of volmap locks held */ 
2 n_vtoc_map_locks_held fixed bin (17), /* Current number of VTOC Map locks held */ 
2 last_volmap_time fixed bin (71), |. /*+ Time a volmap was last locked/unlocked +*/ 
2 last_vtoc_map_time fixed bin (71), /* Time a VTOC Map was last locked/unlocked */ 
2 total_volmap_lock_time fixed bin (71), /* Total time volmap’s were locked (integral) */ 
2 total_vtoc_map_lock_time fixed bin (71), /* Total time VTOC Maps were locked (integral) */ 
2 n_volmap_locks fixed bin (35), /* Number times a volmap was locked */ 
2 n_vtoc_map_locks fixed bin (35), /* Number times a vtoc_map was locked */ 
2 volmap_lock_nowait_calls Fixed bin (35), /* Number calls to tock volmap, no wait */ 
2 volmap_lock_nowait_fails fixed bin (35), /* Number times lock failed */ 
include.**, hard. source pyvt.incl.plt : Page 74 
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2 volmap_lock_wait_calls fixed bin (35), /* Number calls to lock volmap, wait */ 
2 volmap_lock_wait_fails fixed bin (35), /* Number times lock failed */ 
2 pad (2) bit (36) aligned, 


2 array fixed bin (71); /* Array of PVTE’s -- must be double-word aligned */ 


END INCLUDE FILE ...pvt.incl.plt */ 


**, hard.source pyvt.incl.pli 
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pvte.incl.pli1 


segment 


in: >dd>include contents modified: 10/13/82 1310.8 


entry modified: 10/13/82 1311.9 


F8OA - Not to be! reproduced 


/* START OF: pvte. incl.plit July 1982 a 2 A 
dcl pvt$array aligned external; 
dc} pvt$max_n_entries fixed bin external; 
dc) pvt_arrayp ptr; 
dal pvtep ptr; 
dc} 1 pvt_array (pvt$max_n_entries) aligned like pvte based (pvt_arrayp); 
dol 1 pvte based (pvtep) aligned, 
2 pvid bit (36), /* physical volume ID */ 
2 Ivid bit (36), /* Yogical volume ID */ 
2 dmpr_in_use (3) bit (1) unaligned, /* physical volume dumper interlock */ 
2 pad3 bit (6) unaligned, ; ; 
2 skip _queuve_count fixed bin (18) unsigned unaligned, /* number of times this pv skipped for per-proc allocation du 
e to saturation */ : 
2 brother_pvtx fixed bin (8) unaligned,/* next pvte in Iv chain «/ 
2 devname char (4), /* device name */ 
(2 device_type fixed bin (8), /* device type */ 
2 logical_area_number fixed bin (8), /* disk drive number */ 
2 used bit (1), /* TRUE if this entry is used +*/ 
2 storage system bit (1), /* TRUE for storage system (vs io disk) */ 
2 permanent bit (1), /* TRUE {f cannot be demounted */ gery 
2 testing bit (1). /* Protocol bit for read_disk$test */ 
2 being_mounted bit (1), /* TRUE if the physical volume is being mounted */ 
2 being _demounted bit (1), /* TRUE if the pysical volume is being demounted */ 
2 check_read_incomplete bit (1), /* page control should check read incomplete */ 
2 device _inoperative bit (1), /* TRUE if disk_control decides dev busted +/ 
2 rpv bit (1), /* TRUE if this is the root physical volume */ 
2 scav_check_address 
bit (1), /* TRUE ts page control should check deposits/withdrawals against scaven 
ger table +/ 
2 deposit_to_volmap bit (1), /* TRUE if deposits should got to volume map, not stock */ 
2 being demounted2 bit (1), /* No more vtoc I/O during demount */ 
2 pads bit (1), : 
2 vacating bit (1), /* don’t put new segs on this vol */ 
2 hc_part_used bit (1), /* HC part set up by init_pvt */ 
include.**, hard: source pvte.incl pli Page 76 


dc} 


/* END OF: 


includ 
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volmap_lock_notify bit (1) unal, /* 
volmap_idle_notify bit (1) unal, /* 
vtoc_map_lock_notify bit (1) unal, 


n_free_vtoce 
vtoc_size 


dbmurp 


nieft 
totrec 


dim_info 


curn_dmpr_vtocx 
n_vtoce 


baseadd 
pad2 


volmap_seg_sdw 


volmap_astep 
volmap_offset 
vtoc_map_offset 
volmap_lock 
vtoc_map_lock 


volmap_stock_ptr 


vtoc_map_stock_ ptr ptr unal, 


volmap_async_state fixed bin 
volmap_async_page 


vol_trouble_ count fixed bin (17) unaligned, 
scavenger_block_rel bit (18) unaligned; 


‘ 
(VOLMAP_ASYNC_IDLE 
VOLMAP_ASYNC_READ 
VOLMAP_ASYNC_WRITE 


pvte.incl.pit 


hard.source 
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TRUE {if notify required when volmap tock is unlocked */ 
TRUE 1f notify required when volmap state is idle */ 
/* TRUE If notify required when vtoc map lock is unlocked */ 


number of free VTOC entries */ 


fixed bin (17), /* 

fixed bin (17), /* size of the VTOC part of the disk - in records */ 
(2) bit (18), /* rel ptr to dumber bit maps for this volume */ 
fixed bin (17), /* number of records left */ 


fixed bin (17)) unaligned, /* Total records in this map */ 


bit (36), /* Information peculiar to DIM +*/ 
current vtocx being dumped */ 


(3) fixed 
number of vtoce on this volume */ 


fixed bin 


bin unaligned, /* 
unaligned, /* 


fixed bin (18) uns unaligned, /* Base of paging region */ 7 
bit (18) unaligned, 


fixed bin (71), /* SDW describing volmap_seg */ 

ptr unal, /* Packed pointer to ASTE for volmap_seg */ 
bit (18) unal, /* Offset in volmap_seg of volume map */ 
bit (18) unal, ; /* Offset in volmap_seg of VTOC map */ 

bit (36) aligned, /* Lock on volume map operations */ 

bit (36) aligned, | /* Lock on VTOC map operations +/ 

ptr unal, /* Packed pointer to record stock */ 


/* Packed pointer to VTOCE stock */ 


(17) unaligned, /* Asynchronous update state of Volume Map */ 
fixed bin (17) unaligned, /* Page number for asynchronous update */ 

/* Count of inconsistencies since tast salvage */ 
/* Offset to scavenger block, *O *> scavenging */ 


init (0), /* for volmap_async_state */ 
init (1), 


init (2)) fixed bin int static options (constant); 


pvte.inct.pli "“-ge 7 
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rnt.incl.pit 


segment in; | >Idd> include contents modified: 


entry modified: 03/10/82 0836.6 


/* BEGIN INCLUDE FILE RNT.INCL.PL1 - WRITTEN SEPTEMBER 1974 BY R. BRATT +*/ ° 
/* modified July 1976 by R. Bratt; updated March 1977 by M. Weaver */ 
/* modified November 1977 by M. Weaver to use PL/I offsets instead of pointers +/ 


dcl (rntp, entep) ptr; 
dcl Ith fixed bin (17); 
dcl based_rnt_area area based; 


dc! 1 
2 
2 


NO f fo 


dcl 


RO > = 


rnt aligned based (rntp), 
areap ptr, 
meters, 
3 insert, 
4 trys fixed bin (17) unaligned, 
4 wins fixed bin (17) unaligned, 
3 get_segno like insert, 
3 get_refnames like insert, 
3 delete _segno like insert, 
3 delete name like insert, 
rnt_area_size fixed bin, 
srulep ptr, 


/* pointer to area for rnte allocations */ 


name_hash_table (0:127) offset (rnt.areap -> based_rnt_area), 
segno_hash_table (0:127) offset (rnt.areap -> based_rnt_area); 


rnte aligned based (rntep), 


name_fp offset (rnt.areap -> based_rnt_area), 


segno_fp offset (rnt.areap -> based_rnt 


(2 segno fixed bin (17), 


2 


length fixed bin (17), 


_area), 


2 name char (Ith refer (rnte. length) ))unal igned; 
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include.**, hard.source 
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rnt.incl.pli 
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scavenger _data.incl.pli segment 


entry modified: 


tet Rene pe A Re ce en hee 


/* START OF: scavenger_data.tncl.plt November 1962 


/* format: styled */ 


del scavenger _data$ external; 
dcl scavenger_datap ptr; 
dc} sc_metersp ptr; 
dcl sc_process_tablep ptr; 
dc scavenger_blockp ptr; 
dcl record_blockp ptr; 
dc} scavenger_optionsp ptr; 
dc} sC_N_processes Fixed bin; 
dcl scavenger_n_records fixed bin; 
dcl scavenger_n_ovf} fixed bin; 
dcl 1 scavenger _data aligned based (scavenger_datap), 
2 lock aligned, /* 
3 lock_word bit (36) aligned, 
3 watt_event bit (36) aligned, 
3 notify_sw bit (1) aligned, 
2 process table ptr 
ptr, /* 
2 error_severity fixed bin, /* 
2 meters aligned like sc_meters, 
2 free bit (1) aligned; /* 
dcl 1 sc_meters aligned based (sc_metersp), /* 
2 n_scavenge fixed bin (35), /* 
2 pf fixed bin (35), /* 
2 vcpu fixed bin (71), /* 
2 clock_time fixed bin (71), /* 
2 n_vtoces fixed bin (35), /* 
2 n_vtoces_damaged 
fixed bin (35), /* 
2 n_vtoces_per_proc 
fixed bin (35), /* 
2 n_vtoces_per_boot 
fixed bin (35), /* 
2 n_vtoces_freed fixed bin (35), /* 
2 n_vtoces_fmd fixed bin (35), /* 
2 n_records fixed bin (35), /* 
2 n_conflicts fixed bin (35), /* 
2 n_fmd_conflicts fixed bin (35), /* 
2 n_real_conflicts 
fixed bin (35), /* 
2 n_lost_records fixed bin (35); /* 


ni rer a cen en ne nar ep rer teenanent 


includ °*, hard.source 
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scavencgier_data ~ *cl 


in: >Idd>include contents modifted: 11/19/82 1602.2 
11/19/82 1604.3 
er a a i a ee od 
Lock on scavenger_data */ 
Pointer to scavenger process table */ 
Severity of unexpected error condition */ 
Avatlable region */ 
Meters */ 
Number of volume scavenges */ 
Total page faults +*/ 
Total virtual CPU time */ 
Total clock time */ 
Number VTOCEs examined */ 
Number VTOCEs damaged by scavenge +*/ 
Number per-process VTOCEs freed */- 
Number per-bootload VTOCEs freed */ 
Total number VTOCEs freed */ 
Number VTOCEs with fm_damaged reset */ 
Number non-null filemap entries examined */ 
Number potential conflicts detected */ 
Number potential conflicts due to fm_damaged */ 
Number real conflicts */ 
Number lost records freed +/ 
.plt “age 
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dc) 


dc) 


dc} 


dc) 


dc} 


dc} 


/* 


include, **, 


1 sc_proce 


2 max_n_processes fixed bin, 


SS_table aligned based (sc_process tablep), 
/* Number of table entries */ 


2 n_processes fixed bin, /* Number active entries +*/ 
2 process (sc_n_processes refer (sc_process_table.max_n_processes)) aligned, 
- 9 processid bit (36) aligned, /* Owner. O=>empty */ 

3 pvtep ; ptr unal, /* PVTE of volume being scavenged */ 

3 blockp ptr unal, /* Block w/i scavenger_data */ 

3 first_block_page 

fixed bin, /* Index of first page of block */ 
3 n_block_pages fixed bin; /* Number of pages in block */ 


1 scavenge 


r_block aligned based (scavenger_blockp), 


2 n_records fixed bin, /* Number of record addresses */ 

2 n_ovfl fixed bin, /* Number of overflow blocks */ 

2 ovfl_free_ix fixed bin, /* Index of first free overflow block */ 

2 records (scavenger_n_records refer (scavenger_block.n_records)) aligned like record_block, 

2 overflow (scavenger_n_ovfl refer (scavenger _block.n_ovfl)) aligned like record block; 
1 record_block aligned based (record_blockp),/* One per record address */ 

2 vtocx fixed bin (15) uns unal, /* Owning VTOCE index */ 

2 pageno fixed bin (8) uns unal, /* Owning page number */ 

2 state fixed bin (2) uns unal, /* State */ 

2 lock bit (1) unal, '  /* Lock bit on this block */ 

2 ovf ix fixed bin (10) uns unal; _ /* Index of first overflow block on chain */ 


1 scavenge 


2 page 
3 word 


r_data_pages 4 
- aligned based (scavenger_datap), 

(0:255) aligned, 

(1024) bit (36) aligned; 


1 scavenger_options aligned based (scavenger_optionsp), 


( 
STATE_UNSE 


2 print_meters bit (1) unaligned, /* ON => meter each scavenge into the log */ 
2 debug bit (1) unaligned, /* ON => do special debugging things */ 

2 dump bit (1) unaligned, , /*+* ON => dump bad VTOCEs into syserr log */ 
2 trap bit (1) unaligned, /* ON => trap to BOS for debug */ 

2 no_optimize bit (1) unaligned; /* ON => no VTOCE read-ahead */ 


EN init (0), 
STATE_FREE init (4), 
STATE_IN_USE init (2), 
STATE_CONFLICT init (3) 
) fixed bin int static options (constant); 
END OF: scavenger_data.incl.plt , ee 


hard. source scavenger_data.incl.plt 
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scs.incl.pli segment 


in: >Idd>include contents modified: 04/29/82 


entry modified: 04/29/82 1136.4 


/* BEGIN INCLUDE FILE scs.incl.plt ... April 1982 */ 


/* Information about system controllers */ 


dcl 1 scs$controller_data (0:7) aligned ext, 
2 size fixed bin (17) unaligned, 
2 base fixed bin (17) unaligned, 
2 eima_data (4) unaligned, 
3 mask_available bit (1) unaligned, 
3 mask_assigned bit (1) unaligned, 
3 mbz bit (3) unaligned, 
3 mask_assignment fixed bin (3) unaligned, 
2 info aligned, 
online bit (1) unaligned, 
offline bit (1) unaligned, 
store_a_online bit (1) unaligned, 
store_at_ontine bit (1) unaligned, 
store_b online bit (1) unaligned, 
store_bt_online bit (1) unaligned, 
store_b_is_lower bit (1) unaligned, 
ext_interlaced bit (1) unaligned, 
int_interlaced bit (1) unaligned, 
four_word bit (1) unaligned, 
cyclic_priority (7) bit (1) unaligned, 
type bit (4) unaligned, 
abs_wired bit (1) unaligned, 
program bit (1) unaligned, 
mbz bit (13) unaligned, 
2 lower_store_size fixed bin (17) unaligned, 
2 upper_store_size fixed bin (17) unaligned; 


LOR AAR AR AR AR ARAB AR ARAM ARSE A) 


/* Information about CPUs */ 
dcl 1 scs$processor_data (0:7) aligned ext, 


online bit (1), 

offline bit (1), 

release_mask bit (1), 

accept_mask bit (1), 

delete cpu bit (1), 

interrupt_cpu bit (14), 

halted_cpu bit (1), 

cpu_type fixed bin (2) unsigned, 

mbz bit (21), 

expanded port bit (1), 

expander_port fixed bin (2) unsigned, 
controller_port fixed bin (3) unsigned 
unaligned; 


wR NHADNA HMA NNNDN NH 
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include **, hard.source 
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scs.incl.pli 


per-controller info */ 

size (in 1024 word blocks) of this controller “iy 

abs address (O mod 1024) for base of this controller */ 
EIMA information for this controller */ 

ON tf corresponding mask exists */ 

ON if mask assigned to a port */ 


port to which mask is assigned */ 


ON if controller is online «f/f 

ON if controller is offline but can be added +/ 
ON if store A ts online */ : 

ON if store A1 is online */ 

ON if store B is online */ 

ON if store Bt is ‘online */ 

ON .if store B'ts lower */ | 

ON if this SCU is interlaced with other SCU */ 
ON 1f this SCU is internally interlaced */ 

ON if external intertace is 4-word */ 

Cyclic priority for adjacent ports */ 

Model number for this controller */ 

ON if controller can have abs_wired pages */ 
PROGRAM/MANUAL switch setting */ 


size (in 1024 word blocks) of lower store */ 
size (in 1024 word blocks) of upper-store */ 


information about CPUs in the system *+*/ 


"4"b if CPU is online */ 

“t"b if CPU 1s offline but can be added */ 

“{"b is this CPU is to give up its mask */ a 
“i"b if this CPU is to grap mask in idle loop +/ 

“*"b if this CPU is to delete itself */ 

“i"b if this CPU takes hardware interrupts */ 

“i"b if this CPU has stopped itself (going to BOS) */ 
O => DPS or L68, 1 => DPSS */ 


"4"b = on expanded port */ 
The actual expander port */— 


Port on controller */ 


81 


dcl 


dcl 


1 scs$port_data (0:7) aligned external static, /* 
2 assigned fixed bin (4) unsigned unaligned, /* 
2 expander_port bit (1) unaligned, /* 
2 expanded_cpu (0:3) bit (1) unaligned, /* 
2 iom_number fixed bin (3) unsigned unaligned, /* 
2 cpu_number (0:3) fixed bin (3) unsigned unaligned, /* 

fa 
2 pad btt (12) unaligned; 

1 scs$cow (0:7) aligned external, : /* 
2 pad bit (36) aligned, /* 
2 cow, 

3 sub_mask bit (8) unaligned, /* 
3 mbz1 bit (13) unaligned, 

3 expander_command bit (3) unaligned, /* 
3 mbz2 bit (2) unaligned, 

3 expanded_port bit (1) unaligned, /* 
3 expander_port fixed bin (3) unsigned unaligned, /* 
3 mbz3 bit (3) unaligned, 

3 controller_port fixed bin (3) unaligned unsigned; /* 

1 scs$cow_ptrs (0:7) external aligned, /* 
2 rei_cow_ptr bit (18) unal, /* 
2 pad bit (12) unal, 

2 tag bit (6) unal; : /* 

1 scsfreconf ig general_cow aligned external, /* 
2 pad bit (36) aligned, 

2 cow, /* 
3 sub_mask bit (8) unaligned, /* 
3 mbz1i bit (13) unaligned, 
3 expander_command bit (3) unaligned, /* 
3 mbz2 bit (9) unaligned, 
3 controller_port fixed bin (3) unaligned unsigned; /* 


/* MASKS and PATTERNS */ 


dc} 
dc} 
dcl 
dcl 
dcl 
dc} 
dc} 


scs¢sys_level bit (72) aligned ext; a A. 
scs$open_level bit (72) aligned ext; /* 
scs$processor_start_mask bit (72) aligned ext; /* 
scs$cpu_test_mask bit (72) aligned ext; /* 
scs$number_of_masks fixed bin ext; /* 
scs$processor_start_pattern bit (36) aligned ext; /* 
scs$cpu_test_pattern bit (36) aligned ext; /* 


/* CAM and CACHE clear info */ 


dcl 
dc} 


scs$cam_pair fixed bin (71) ext; — /* 
scs$cam_wait bit (8) aligned ext; /* 


/* MASKING INSTRUCTIONS & POINTERS */ 


dc} 
dc} 


include. **, 


FBOA 


scs$set_mask (0:7) bit (36) aligned ext; /* 
scs$read_mask (0:7) bit (36) aligned ext; /* 


hard. source 


~ Not to he reproduced 


scs.incl.pl1 


about what 1s connected to each SCU port eA 

of device on this port 

“i"b => this port has a port expander +/ 

“i"b => this expander port has a CPU attached */ 

10M number of IOM attached to this port */ 

CPU number of CPU(s) attached to this port */ 
cpu_number (0) is only one if expander_port is "O"b */ 


Info 
Type 


Actual connect words */ 
Expander COW’s must be odd-word +/ 


Expander sub-port mask *«/ 
Expander command. */ 


“4"b = on expanded port */- 
Port on expander for cioc */ 


controller port for this CPU «/ 


Pointers to COW’s */ 
Relative potter to COW */ 


Better be zero. */ 
Used during reconfig ops. +*/ 


Connect operand word, in odd location. */ 
Expander sub-part mask */ 


Expander command. */ 


controller port for this CPU */ 


used while handling 1/0 interrupts */ 

used during normal operation */ 

mask used when starting up a CPU */ 

mask used for ISOLTS CPU testing */ 

number of masks (starting at sys_level) */ 

SMIC pattern used to send processor start interrupt */ 
SMIC pattern used for ISOLTS processor testing */ 


mask 
mask 


instructions XEDd when CAMing and clearing CACHE */ 
Used when evicting pages from main memory */ 


instructions to set mask (STAQ or SMCM) */ 
instructions to read mask (LUDAQ or RMCM) */ 


Page 
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dc! scs$mask_ptr (0:7) ptr unaligned ext; /* 


/* MISCELLANEOUS */ 


dc! 1 scs$processor_test_data aligned ext, /* 
2 active bit (1), /* 
2 scu_state bit (2), /* 

2 padi bit (15), 

2 cpu_tag fixed bin (5), _/* 
2 scu_tag fixed bin (5), /* 
2 mask _cpu fixed bin (5) 
) unaligned; /* 


/* scu_state = 
/* scu_state = 
/* scu_state = 
/* scu_state = 


"OO"b => 
“Ol"b => 
“10"b => 
“11"%b => 


SCU defined by scs$processor_test_data. 


dc! scs¢idle_aptep (0:7) ptr unaligned ext; /* 
dcl scs$connect_lock bit (36) aligned ext; /* 
dcl scs$reconfig lock bit (36) aligned ext; /* 
dcl scs$trouble flags bit (8) aligned ext; /* 
dcl scs$bos_restart_flags bit (8) aligned ext; /* 
dct scs$nprocessors fixed bin ext; _ fe 


dcl scs$bos_processor_tag fixed bin (3) ext; /* 
dcl scs$faults_initialized bit (1) aligned ext; /* 
dc! scs$sys_trouble_pending bit (1) aligned ext; /* 
dcl scs$fast_cam_pending (0:7) bit (36) aligned ext; /* 
dc} scs$interrupt | controller fixed bin (3) ext; /* 
dc! scs$processor_start_int_no fixed bin (5) ext; /* 
dc! scs$processor bit (8) aligned ext; /* 
dc! scs$processor_start_wait bit (8) aligned ext; /* 


dcl scs$trouble_dbrs (0:7) fixed bin (71); "fs 


dc} scs$port_addressing_ word (0:7) bit (3) aligned ext; /* 


dcl scs$cfg data (0:7) fixed bin (71) aligned ext; /* 


dcl scs$cfg_data_save ftxed bin (71) aligned ext; /* 


dc! scs$expanded_ports bit (1) unaligned dim (0:7) external; 


dc! scs%$processor_switch_data (0:4) bit (36) aligned ext; 


/* 


pointers for real or simulated masks */ 


info used for cpu testing */ 


= "{"b if cpu currently under test «/ 
state of scu being used for testing (see definition below) */ 


tag of cpu under test */ 
tag of scu being used for cpu testing «/ 


tag of active cpu that has mask asigned to above scu */ 


scu_tag not yet effected */ 
all core removed from SCU, port mask not yet changed */ 
all core removed from SCU, port mask changed */ 

only 64k at base of SCU being used for testing, original port weet restored */ 


pointer to idle process APTE for each processor */ 


lock for sending connects */ 
Lock used during reconfiguration */ 


checkoff flags for 
checkoff flags for 


sys_trouble stopping */ 
restarting after sys_trouble */ 


number of runnung processors +*/ 

CPU tag of processor running BOS */ 

ON after faults have been enabled */ 
sys_trouble event is pending in the system */ 


checkoff cells for 
port number of low 
interrupt cell) for 
bits ON for online 
checkoff flags for 


cam connect */ 
order controller */ 

starting a processor */ 

CPUs */ 

waiting for new processor */ 


DBR values at system crash time +/ 


active module port 
RSCR-CFG data from 


RSCR-CFG save area 


number for each controller */ 
each controller */ 


for ISOLTS CPU testing */ 


Which ports have expanders */ 


/* raw data from RSW O thru 4 */ 


dc! scs$processor_switch_template (0:4) bit (36) aligned ext;/* expected data from RSW O thru 4 */ 
dct scs$processor_switch_compare (0:4) bit (36) aligned ext; /* discrepanctes from expected data */ 


dc! scstprocessor_switch_mask (0:4) bit (36) aligned ext; 


del scs$processor_data_switch_value bit (36) aligned ext; 


dc! scs$controller_config size (0:7) fixed bin (14) aligned ext; 
/* Controller size on config card */ 


incluc <**, hard.source 


scs.incl.plf 
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/* masks for comparing switch data */ 


/* Correct value for CPU data switches */ 
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dc} 


dc} 


dct 
dcl 


dc} 


scs$reconf ig locker_id char (32) aligned ext; /* process group ID of process doing reconfiguration «/ 


scs$scas_page_table (0:31) bit (36) aligned external static; 
/* PTWs for SCAS pages */ 


scs$cycle priority template bit (7) aligned ext; /* template for setting anti-hog switches af 
scs$set_cycle switches bit (1) altgned ext; /* flag to set ant-hog switches «/ 


( 

1OM_PORT init (1), 

CPU_PORT init (2), 

BULK_PORT init (3) 

) fixed bin int static options (constant); /* values for scs$port_data.assigned «/ 


/* END INCLUDE FILE scs.incl.plt */ 
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include.**, hard. source scs.incl.pli 
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sdw.168.incl.pli segment in: >Idd>include contents modified: 07/29/81 
entry modified: 03/10/82 0836.9 


ot 


/* BEGIN INCLUDE FILE ... sdw.168.incl.pl1 ... Updated for ADP conversion 03/01/81 */ 
/* Note: This include file has an ALM counterpart made with cif. Keep {it up to date +/ 
dc! 1 168 sdw based (sdwp) aligned, /* Level 68 Segment Descriptor Word */. 
* (2 add bit (24), /* main memory address of page table */ 
2 rings, /* ring brackets for the segment */ 


3 rt bit (3), 
3 r2 bit (3), 
9 r3 bit (3), 


2 valid bit (1), /* directed fault bit (0 => fault) */ 
2 df_no bit (2), /* directed fault number */ 
2 padi bit (1), : 
2 bound bit (14), /*+ boundary field (in 16 word blocks) +/ 
2 access, /* access bits */ 
3 read bit (1), /* read permission bit */ 
3 execute bit (1). . /* execute permission bit */ 
3 write bit (1), /* write permission bit */ 
3 privileged bit (1), /* privileged bit «/ 
2 unpaged bit (1), /* segment is unpaged if this is 1 */ ; 
2 not_a_gate bit (1), /* if this is O the entry bound is checked by hardware */ 
2 cache bit (1), /* cache enable bit */ 
2 entry_bound bit (14)) unaligned; /* entry bound */ 
/* END INCLUDE FILE ... sdw.168.incl.pli */ 


includ “*, hard. source sdw.163.incl.p* 
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sdw_ i 


/* BE 
/* No 
dcl 


dcl 1 
2 


2 


/* END INCLUDE FILE ... Sdw_info.incl.pit */ 


inclu 


F80A 


nfo. incl.pli 


GIN INCLUDE FILE ... sdw_info.incl.pit 


segment in: >»Idd>include contents modified: 07/29/81 
entry modified: 03/10/82 - 0836.9 


12/16/80, for ADP conversion */ 


te: This include file has an ALM counterpart made with cif. Keep it up to date +*/ 


sdw_info_ptr pointer; 


sdw_info aligned based (sdw_info_ptr), 


address fixed bin (26), 
size fixed bin (19), 


access unaligned, 

3 read bit (1) unaligned, 

3 execute bit (1) unaligned, 

3 write bit (1) unaligned, 

3 privileged bit (1) unaligned, 


padi bit (32) unaligned, 
rings unaligned, 

3 ri bit (3) unaligned, 

3 r2 bit (3) unaligned, 

3 r3 bit (3) unaligned, 
pad2 bit (27) unaligned, 
flags aligned, 

3 paged bit (1) unaligned, 
3 faulted bit (1) unaligned, 
3 cache bit (1) unaligned, 
3 pad3 bit (33) unaligned, 


gate_entry_bound fixed bin (14); 


de.**, hard.source 


- Not to be reproduced 


/* Structure describing SDW contents */ 
/* Address of seg base or of page table */ ; 
/* Max length of segment (NOT offset of last word) */ 


/* REWP +/ 


/* Ring brackets */ 


/* “1"b => Segment is paged */ 
/* “1"b => SDW has fault set */ 
/* “1"b => Segment is encacheable */ 


/* Number of entrypoints in gate, or zero */ 


sdw_info.incl.plt i 
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signaller_stack.incl.pli segment in: >Idd>include contents modified: 04/02/79 1405.9 
entry modified: 03/10/82 0836.7 


a tr ert er Se fp A Ser 


/* - BEGIN INCLUDE FILE ... signaller_stack.incl.pl1 ... Created Feb 79 by D.Spector */ 


/* Thts file matches signaller_stack.incl.alm and is currently used only by verify_lock */ 
declare 1 signaller_stack based unaligned, 

2 pad (8) bit (36), /* Make machtne condittons O mod 16 */ 

2 mach_cond (48) bit (36), /* Machine conditions */ 

2 mc_ptr ptr aligned, /* Pointer to machine conditions */ 

2 null_ptr ptr aligned, /* Null pointer */ 

2 string descriptor bit (36), /* Condition name descriptor */ 

2 ptr_descriptor bit (36), /* M.C. ptr descriptor */ 

2 arglist (18) bit (36), /* Arg list for call to signal */ 

2 signal_string char (32), /* Condition name */ 

2 on_unit (16) bit (36), /* Must be at 128 in stack frame */ 

2 history_registers (128) bit (36); 


/* on_unit must start at 128 because trap_caller_caller_ sets up a stack frame 
assuming this to be so. Similarly mach_cond must start at 48. +/ 


/* END INCLUDE FILE ... signaller_stack.incl.pli ... */ 
includ «*, hard. source Signaller_stack ‘ncl.pit . Page 87 
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slt.incl.pli 


segment 


in: >Idd>include contents modified: 05/12/82 


entry modified: 05/12/82 1254.5 


/* BEGIN INCLUDE FILE sIt.incl.plt --- Last modified 2/76 SHW */ 


/* Declarations for Segment Loading Table header and array. 


Used by Initialization and MST Checker subroutines +/ 


dcl sitp ptr, 
names_ptr ptr, 
namep ptr, 
pathp ptr, 
acip ptr; 


declare 1 sit based (sltp) aligned, 

name_seg ptr ptr, 
free_core_start fixed bin (24), 
first_sup_seg fixed bin (18), 
last_sup_seg fixed bin (18), 
first_init_seg fixed bin (18), 
last_init_seg fixed bin (18), 
free’ core_size fixed bin (24), 
seg (0:8191) aligned, 

3 site (4) fixed bin (35); 


OHHH DDD bP 


/* pointer to base of SLT segment */ 

/* pointer to base of SLT names segment +*/ 

/* pointer to segment name list block +*/ 

/* pointer to segment’s directory path name */ 
/* pointer to acl structure +/ 


/* declaration of Segment Loading Table (SLT) */ 

/* words O-1, pointer (ITS pair) to name segment +/ 
/* word 2,° start of free core after perm-wired */ 
/* word 3, first supervisor segment number */ 

/* word 4, last supervisor segment number */ 

/* word §, first initializer segment number */ 

/* word 6, last initializer segment number */ 

/* size (in words) of free core after perm-wired «/ 
/* segment entries (4 words each) */ 

/* Space for SLT entries */ 


/* auxiliary segment of SLT for storing of segment names and directory path names */ 


declare 1 name_seg based (names_ptr) aligned, 
2 pad bit (18) unal, 
2 next_loc bit (18) unal, 
2 nt (0:127) bit (18) aligned; 
declare 1 segnam based (namep) aligned, 
2 count fixed bin (17), 
2 names (50 refer (segnam.count)), 
hp bit (18) unal, 
ref bit (141) unal, 
pad bit (5) unal, 
segno bit (12) unal, 
name char (32) unal; 


OW W & 


declare 1 path based (pathp) aligned, 
2 size fixed bin (17), 
2 name char (168 refer (path.size)) unal, 
2 acls fixed bin; , 


acls based (acip) aligned, 

2 count fixed bin, 

2 acl (50 refer (acls.count)), 
3 userid char (32), 
3 mode bit (36) aligned, 


declare 1 


include. **, hard. source 


FBOA - Not to be reproduced 


/* name segment header */ 


/* Next available free location in name seg */ 
/* Names hash table */ 


/* declaration for segment name block */ 

/* number of segment names in this block */ 
/* segment name array +*/ 

/* hash thread pointer */ 

/* “1"b if name referenced */ 


/* segment number associated with this name */ 
/* space for name (max 32 characters) */ 


/* declaration for directory path name */ 
/* length of pathname +*/ 

/* directory path name */ 

/* ACL list starts here */ 


list */ 
list */. 


/* declaration for acl 
/* number of entries in ac) 
/* array of acl entries */ 
/* user specification */ 

/* mode for the specified user */ 


sIt.incl.plt 


1246.5 


Page 


8B 


3 pad bit (36) aligned, 
3 code fixed bin; 


/* END INCLUDE FILE sit.incl.plt */ 


tern atte gee ent 


includ °“*, hard.source sit.inct.pli -ge 389 
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site.incl.plt segment tn: >Idd>include contents modified: 10/06/82 1356.3 
; entry modified: 10/06/82 1359.7 
/* BEGIN INCLUDE FILE site.incl.plt */ 
/* Declaration for Segment Loading Table Entry structure. 
Used by Initialization, MST Generation, and MST Checker subroutines */ 
/* last modified 5/4/76 by Noel I. Morris «/ 
/* format: styled */ 
dc} slitep ptr; 
dc} 1 slte_uns based (sitep) aligned, 
( 2 names_ptr bit (18), /* rel pointer to thread of namas */ 
2 path_ptr bit (18), /* rel pointer to pathname (if present) */- 
/*«++* End of word 1 */ 
2 access bit (4), /* SOW access bit (REWP) */ 
2 cache bit (1), /* Segment to be allowed in cache */ 
2 abs_seg bit (1), /* segment is an abs seg if ON */ 
2 firmware_seg bit (1), /* load in low 256. */ 
2 layout_seg bit (1), /* mailbox & such */ 
2 padi bit (4), /7* unused +*/ 
2 wired bit (1), /* segment is wired if ON */ 
2 paged bit (1), /* segment is paged if ON */ 
2 per_process bit (1), /* segment is per-process if ON */ 
2 pad3 bit (2), ; 
2 acl_provided bit (1), /* ON if acl structure follows path_name on MST */ 
/+**+* End of ist half of word 2 */ 
2 pad4 bit (3), 
2 branch_required bit (1), /* path name supplied if ON */ 
2 init_seg bit (1), /* segment is init _seg if ON */ 
2 temp_seg bit (1), /* segment is temp_seg if ON *«/ 
2 link _provided bit (1), /* linkage segment provided if ON */ 
2 link_sect bit (1), /* segment is linkage segment if ON «/ 
2 link_sect_wired bit (1), /* linkage segment is wired if ON */ 
2 combine_link bit (1), /* Vinkage is combined if ON */ 
2 pre_linked bit (1), /* lot entry has been made if ON */ 
2 defs bit (1), /* segment is definitions segment if ON */ 
/**+** End of word 2 */ 
2 pads bit (6), : 
2 cur_length fixed bin (9) uns, /* current length of segment (in 1024 word blocks) */ 
2 ringbrack (3) fixed bin (3) uns, /* ringbrackets */ 
2 segno fixed bin (18) uns, /* text/link segment number */ 
/***** End of word 3 */ 
2 pad7 bit (3), 
2 max_length fixed bin (9) uns, /* maximum length for segment +*/ 
2 bit_count fixed bin (24) uns 
) unaligned; /* bitcount of segment */ 
dc) 1 site based (slitep) aligned, 
( 2 names_ptr bit (18), /* rel pointer to thread of names */ 
2 path_ptr bit (18), /* rel pointer to pathname (if present) */ 
2 access bit (4), /* SDW access bit (REWP) */ 
include,++, hard.source slte.incl.pli Page 90 
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cache 
abs_seg 


firmware_seg 


layout_seg 
pad2 

wired 
paged 
per_process 
pad3 


acl!_provided 


pad4 


branch_required 


init_seg 
temp_seg 


link_provided 


link_sect 


link_sect_wired 
comb ine_link 


pre_linked 
defs 

pads 
cur_length 
ringbrack 
segno 

pad6 
max_ltength 
bit_count 
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oe © «© © © © we ee ew ew tl tll tl hl hl tl tl 


bit (9), 


bit (24) 
unaligned: 


/* END INCLUDE FILE site.incl.plt */ 


inejudr «*, 


F 8C Jot to be reproduced 


hard.source 


/* 
/* 


slite.incl.pli 


Segment to be allowed in cache */ 
segment is an abs seg if ON */ 


segment is wired if ON */ 
segment {ts paged if ON */ 
segment {ts per-process if ON */ 


ON if acl structure follows path_name on MST */ 


path name supplied if ON */ 

segment is init_seg if ON */ 

segment is temp_seg if ON */ 

linkage segment provided if ON */ 
segment is linkage segment if ON */ 
linkage segment is wired if ON */ 
linkage {ts combined if ON */ 

lot entry has been made if ON */ 
segment is definitions segment {f ON */ 


current length of segment (in 1024 word blocks) */ 
ringbrackets */ 

text/link segment number +/ 

maximum length for segment */ 


bitcount of segment */ 
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sst.incl.pli segment 


entry modified: 


/* BEGIN INCLUDE FILE . SSt.incl.plt January 1971 */ 

/* Note: This include file has an ALM counterpart made with cif. 
dcl sst_seg$ external; 

dcl sstp ptr; 

dc) 1 sst based (sstp) aligned, 


2 space (8) fixed bin, 
/* SST HEADER */ 


pre_page time fixed bin (71), 
post_purge time fixed bin (71), 
post_in_core fixed bin, 
thrashing fixed bin, 

npfs_ misses fixed bin, 

Salv fixed bin, 


PWN NP 


pt) bit (36), 

astl bit (36), 

astl_event bit (36), 
astl_notify_requested bit (1) aligned, 
nused fixed bin, : 
ptwbase fixed bin (24), 

tfreep ptr, 


RR PM BD PO 


astap ptr, 

bulk_pvtx fixed bin (8) aligned, 
ptl_wait_ct fixed bin, 

astsize fixed bin, 

cmesize fixed bin, 

root_astep ptr, 


RMD RR 


pts (0: 3) fixed bin, 
level (0:3), 
3 (ausedp, no_aste) bit (18) unaligned, 


RS fh 


(atempp, atempp1!) bit (18) unal, 
dm_enabled bit (1) aligned, 
(ainitp, ainitpt) bit (18) unal, 
strsize fixed bin, 


RR BH PD 


/* CORE MAP HEADER */ 
2 cmp ptr, 


2 usedp bit (18), 
2 wtct fixed bin, 


include.**, hard.source 
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/* 


sst.incl.plt 


>Idd> include contents modified: 11/19/82 1602.2 


11/19/82 1604.3 


in: 


Keep it up to date */ 


empty space to watch for bugs */ 


total 
total 
total 


time spent pre-paging */ 

time spent post-purging *«/ 

pages in core (and in list) at purge time */ 
meter of thrashing being done on system */ 

meter of times npfs was on when pre-paging */ 

flag which is *=0 if and only if salvaging */ 


global page table loop lock */ 

global ast allocation block lock */ 
event used when waiting for AST lock */ 
flag to notify AST lock */ 

number of pages on used list */ 

absolute address of page table array */ 
pointer to first trailer on free list */ 


array pointer */ 
of bulk store, zero if none */ 
number is >= # of processes waiting to ptl 
size of an AST entry */ 
size of a CME entry */ 
pointer to the root AST entry */ 


aste 
pvtx 
Pxss: 


*/ . 


array of page table sizes */ 
per-list information about ASTE’s +*/ 
used list and count of number of entries */ 


temp seg list pointer +/ 
ON => journal seg exists */ 
init seg list pointer +*/ 
Trailer size in words. */ 


pointer to start of core map */ 
pointer to first used core block */ 
count of pages being written */ 


Page 
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2 startp bit (18), /* 
2 removep bit (18), /* 
/* 
2 double write fixed bin, /* 
/* 


2 temp_w_event bit (36) aligned, 


2 root_pvtx fixed bin, /* 
2 ptw_first bit (1) aligned, /* 
2 nolock bit (1), /* 
2 x_fsdctp bit (18). /* 
2 fc_skips_pinned fixed bin (35), /* 
2 cl_skips_pinned fixed bin (35), /* 
2 ast_ht_ptr ptr, /* 
2 ast_ht_n_buckets fixed bin, /* 
2 ast_ht_uid_mask bit (36) aligned, /* 
2 meter_ast_locking fixed bin, /* 
2 


checksum_filemap fixed bin, 


/* 100 octal */ 


pointer to solid page for lap counting (fsdct) */ 
pointer to list of pages being removed from use */ 
MISC */ : 

trigger for store through scheme +*/ 

O = no double writes, 


1 = all non-pd pages get written, 
2 = all directories get written */ 
wait event for temp wiring lock */ 


pyvtx or rpv +*/ 

flag controlling when pages go to pd */ 
if on, don’t lock pt! on interrupts */ 
removed by thvv */ 


number of skips over pinned page in find_core */ 
number of skips over pinned page in claim_mod_core */ 
AST hast table pointer */ 

number of buckets in AST hash table +*/ 

mask to strip out low-order bits of uid */ 

non-zero enables AST lock meters */ 

non-zero enables filemap checksumming */ 


2 page _read_errors fixed bin, /* read errors posted to page control */ 
2 page_write_errors fixed bin, /* write errors posted to page control */ 
2 rws_read_errors fixed bin, /* read-side rws errors */ 
2 rws_write_errors fixed bin, /* write-side rws errors */ 
2 cycle pv_allocation fixed bin, /* flag to cycle VTOCE allocation among PVs */ 
2 n_trailers fixed bin, /* Number of trailer entries in str_seg */ 
2 synch_activations fixed bin (35), /* Activation attempts for synchronized segs */ 
2 synch_skips fixed bin (35), /* get_aste skips because not synchronized */ 
2 lock_waits fixed bin, /* Number of times we had to wait for a lock */ 
2 total_locks_set fixed bin, /* Total number of block locks set */ 
2 pdir_page_ faults fixed bin, /* total page faults off >pdd */ 
2 level_1_page_faults fixed bin, /* total page faults in sys libes +/ 
2 dir_page_faults fixed bin, /* Total page faults on directories */ 
2 ring_O page_faults fixed bin, /* page faults in ring O */ 
2 rqover fixed bin (35), /* errcode for record quota overflow */ 
2 pce_io_waits fixed bin, /* Number of times pc had to wait on to */ 
/* The following (until pdmap) used to be the ‘cnt’ in cnt. incl.plt */ 
"2 steps fixed bin, /* number of steps taken around used list */ 
2 needc fixed bin, /* number of times core page needed +*/ 
2 ceiling fixed bin, /* number of times ceiling hit */ 
2 ctwait fixed bin, /* number of times write counter was full */ 
2 wired fixed bin, /* number of pages wired by pc */ 
2 laps fixed bin, /* number of times around used list */ 
2 skipw fixed bin, /* number of pages skiped because they were wired */ 


jnclud —*, hard.source 
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2 skipu fixed bin, /* 
2 skipm fixed bin, /* 
2 skipos fixed bin, /* 
2 skipspd fixed bin, /* 
2 aused fixed bin, /* 
2 damaged _ct fixed bin, /* 
2 deact_count fixed bin, /* 
2 demand_deact_attempts fixed bin, /* 
2 demand_deactivations fixed bin, /* 
2 reads (8) fixed bin, /* 
2 writes (8) fixed bin, /* 
2 short_pf_count fixed bin, /* 
2 loop_locks fixed bin, /* 
2 loop_lock_time fixed bin (71), /* 
2 cpu_sf_time fixed bin (71), /* 
2 total_sf_pf fixed bin, fig 
2 total_sf fixed bin, /* 
2 pre_page_size fixed bin, /* 
2 post_list_size fixed bin, 

2 post_purgings fixed bin, /* 
2 post_purge_ calls fixed bin, /* 
2 pre_page calls fixed bin, /* 
2 pre_page_list_size fixed bin, 

2 pre_page_misses fixed bin, /* 
2 pre_pagings fixed bin, . [* 


/* 200 octal */ 
/* TEMPORARY WIRED PROCEDURE INFO */ 
2 wire_proc_data (8) fixed bin (71), /* 


/* MAIN MEMORY USAGE INFORMATION */ 


2 abs_wired_count fixed bin, * f* 
2 system_type fixed bin, ‘/* 
2 wired_copies fixed bin, /* 
2 recopies fixed bin, /* 
2 first_core_block fixed bin, /* 
2 last_core_ block fixed bin, /* 
2 fw_retries fixed bin (35), /* 
2 pvhtp ptr unaligned, /* 


/* AST METERS” */ 


2 askipsize (0: 3) fixed bin, /* 
2 aneedsize (0: 3) fixed bin, /* 
2 stepsa fixed bin, . /* 
2 askipsehs fixed bin, /* 
2 asearches fixed bin, /* 
2 askipslevel fixed bin, /* 


because of being used */ 


because of being modified +/ 

because out of service */ 

number of times a block of core was skipped for active rws */ 
number of AST entries on used Vist */ 

count of segments that system damaged */ 

count of deactivations */ 

user requested deactivations */ 

user instigated deactivations */ 


number of reads for each did */ 
number of writes for each did */ 


count of page faults on out of service pages */ 
count of times locked PTL */ 

time spent looping on PTL */ 

cpu time spent in seg fault */ 

total page faults while in seg fault */ 

total number of seg faults */ 

total pre-pagings expected */ 


total 
total 
total 


post-purgings */ 
calls to post-purge */ 
calls tp pre-page +/ 


number of 
number of 
number of 


total 
total 


misses in pre-page list */ 
pre-pagings */ 


number of 
number of 


data for wire_proc */ 


count of abs-wired pages */ 

ADP_SYSTEM or. L68_ SYSTEM */ 

number of times a wired page was copied */ 
number of times recopied because modified */ 
core map index for first block of core */ 
core map index for last block of core */ 
force_write retries due to ASTE move */ 

ptr to PV hold table for debuggfng */ 


array of skips because wrong AST size */ 

array of times needed each size */ 

count of steps taken looking for an AST entry */ 
count of skips because EHS was ON */ 

count of full searches made */ 

count of skips because pages were in core */ 


ercvire bree tea nme smb pemampmn pinnae reves snadtsenpeninnt sine here etabemr bree ee tn rat ti PP SPS veh vice San wines SAP STOP 9) tt ener eto eon test tryst tiie si rr A nes ens tissues usenet 
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/* 
/* 


/* 


/* 
/* 
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askipsinit fixed bin, 
acost fixed bin, 

askipslock fixed bin, 
askipdius fixed bin, 


alaps fixed bin, 

updates fixed bin, 
setfaults_all fixed bin, 
setfaults_acc fixed bin, 
total _ bf fixed bin, 
total bf _pf fixed bin, 
cpu_bf_time fixed bin (71), 


asteps (0: 3) fixed bin, 


ast_locked_at_time fixed bin (71), 


ast_ locked _ total _time fixed bin (71), 


ast_lock_watt_time fixed bin (71), 
ast_locking count fixed bin (35), 
cleanup_count fixed bin, 
cleanups_with_any_rws fixed bin, 
cleanup_rws_count fixed bin, 
cleanup_real_tima fixed bin (71), 


PRE-PAGE METERS */ 


300 octal */ 


2 


tree_count (0: 63) fixed bin, 


400 octal */ 


2 


pp_meters (0: 63) fixed bin, 


End of old cnt include file */ 


500 octal */ 
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wusedp bit (18) aligned, 
write _ hunts fixed bin, 
claim_skip_cme fixed bin, 
claim_skip_free fixed bin, 
cClaim_notmod fixed bin, 
claim_passed_used fixed bin, 
Claim_skip_ptw fixed bin, 
claim_writes fixed bin, 
claim_steps fixed bin, 
rws_reads_os fixed bin, 
pd_updates fixed bin, 

pre_seeks failed fixed bin, 
pd_desperattion_steps fixed bin, 
pd_desperations fixed bin, 
skips _nypd fixed bin, 
pd_writeahead bit (1) aligned, 
pd_desperations_not_mod fixed bin, 


ae mete et earn araneeatptrert een ear ee rss 


include *+*, 


F80a=- 


hard. source 


*pt to be reproduced 


/* 


/* 


count of times turned OFF init switch */ 
cumulative cost of deactivations */ 

count of skips because couldn’t lock parent */ 
count of skips because DIUS was on */ 


Jap counter for AST list */ 

calls to updateb */ 

setfaults done to the entire SDW */ 
setfaults done to the access field */ 
count of bound faults */ 

page faults during bound faults */ 
cpu time spent in bound fault */ 


per-size AST step counters */ 


clock reading when ast last locked */ 

total real time the ast lock was locked *«/ 
total real time of all waiting on ast lock */ 
number of times ast was locked */ 

calls to pc$cleanup */ 

ditto, with >0 rws’s */ 

total rws’s started by cleanup */ 

total real time in pc$cleanup */ 


counters for pre-page decisions */ 


counters for measuring pre-page success */ 


Relative cmep to next cme for writing */ 
Times claim_mod_core invoked */ 

Times unacceptable cme found by c_mic */ 
Times free cme passed by c_m_c */ 

Times c_m_c passed pure page */ 

Times used page seen */ 

Times c_m_c saw unacceptable ptw “f 

Writes queued by c _m_ic */ 

Steps passed in core claiming «/ 

RWS reads outstanding, tn SST for debugging */ 
done_ time pd writes */ 

counter of times quick find_core_ failed «/ 
steps of allocate_pd finding pdme */ 

times allocate_pd needed to force one free */ 
find_core skips for nypd pages */ 

"4"b => allocate_pd at disk done time */ 
desperations on pure pages */ 
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resurrections fixed bin, ; /* nulled addresses reinstated of 


2 
2 volmap_seg page_faults fixed bin (35), /* Pseudo-page faults on volmap_seg */ 
2 oopv fixed bin, /* out-of-physical-volume page faults */ 
2 pdflush_replaces fixed bin, /* addresses “corrected" by post-crash pd flush +*/ 
2 persst statptr ptr unal, /* ptr to damage table of pc_recover_sst */ 
2 pd_resurrections fixed bin, /* addresses resurrected at RWS time */ 
2 dblw_resurrections fixed bin, /* addresses resurrected by double-writing +/ 
2 sgm_time fixed bin (71), /* Time (VCPU) in seg mover */ 
2 sgm_pf fixed bin, /* Page faults in seg moving */ 
2 bad_sgms fixed bin, /* Seg moves that failed */ 
2 sgm_sgft fixed bin, /* Seg faults in seg moves */ 
2 good_sgms fixed bin, /* Seg moves that completed */ 
2 claim_runs fixed bin, /* Times Glaim_mod_core had to run */ 
2 activations fixed bin, /* total count of activations */ 
2 dir_activations fixed bin, /* count of directory activations */ 
2 hedge _updatevs fixed bin, , /* call-in updatevs */ 
2 hedge _ writes fixed bin, /* call in core flush writes +*/ 
2 evict_recover_data, /* see evict _page.alm */ 
3 evict_ptp bit (18) unal, /* ptp of page being moved */ 
3 evict phmbit bit (18) unal, /* N/Z if page was mod */ 


/* Data for metering force write facility 08/19/78 */ 


2 force_swrites fixed bin, /* Calls on segments to force write */ 

2 force _pwrites fixed bin, /* Mod pages so written */ 

2 fw_none fixed bin, /* Force write wrote none +*/ 

2 force_updatevs fixed bin, /* Updatev‘s so forced */ 

2 pf_pd_loop_time fixed bin (71), /* Time looping on pd on page faults */ 

2 pf_unlock_ptl_time fixed bin (71), /* Time unlocking ptin page faults */ 

2 pf_pd_loop_meterings fixed bin, 

2 pf_unlock_ptl_meterings fixed bin, 

2 makeknown_activations fixed bin (35), /* activations at makeknown time *«/ 

2 backup_activations fixed bin (35), /* activations for backup */ 

2 metering _ flags aligned, /* small chunks of misc. information */ 
3 activate_activated bit (1) unal, /* ON => last call to activate entry actually activated something */ 
3 pad bit (35) unal, 

2 seg_fault_calls fixed bin (35), /* number calls to seg fault for explicit activation */ 


/* METERS FOR STACK TRUNCATION */ 

2 (stk_truncate_should_didnt, /* counts */ 
stk_truncate_ should did, 
stk_truncate_shouldnt_didnt, 
stk_truncate_shouldnt_did) fixed bin (35), 

2 stk_pages_truncated fixed bin (35), 

2 stk_pages_truncated_in_core fixed bin (35), 

2 padder (8) fixed bin, 

/* the following data is used by page multilevel *+/ 


/* 6OO octal */ 


include.++*, hard.source sst.incl.pli as. oA Page 
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includ 


pdmap ptr, 

pdhtp ptr, 

pd_id fixed bin (8) aligned, 
pdsize fixed bin, 

pdme_no fixed bin, 

pdusedp bit (18) unaligned, 
pd_first fixed bin, 
pd_map_addr fixed bin, 
nrecs_pdmap fixed bin, 
pd_free fixed bin, 

pd_using fixed bin, 

pd_wtct fixed bin, 

pd_writes fixed bin, 
pd_ceiling fixed bin, 
pd_steps fixed bin, 
pd_skips_incore fixed bin, 
pd_skips_rws fixed bin, 
pd_needed fixed bin, 
mod_during_ write fixed bin, 
pd_write_aborts fixed bin, 
pd_rws_active fixed bin, 
pd_no_free fixed bin, 
pd_read_truncates fixed bin, 
pd_write_truncates fixed bin, 
pd_htsize fixed bin, 
pd_hash_mask bit (18), 
pdmap_astep ptr, 

zero pages fixed bin, 
pd_zero_pages fixed bin, 
trace_sw aligned, 

3 pad_trace bit (32) unaligned, 
3 pe_trace_pf bit (1) unaligned, 
3 tty_trace bit (1) unaligned, 
3 pco_trace bit (1) unaligned, 
3 sc_trace bit (1) unaligned, 
new_pages fixed bin, 
rws_time_temp fixed bin (71), 
rws_time_start fixed bin (71), 
rws_time_done fixed bin (71), 
pd_time_counts (4) fixed bin, 


pd_time_values (4) fixed bin (71), 


pd_no_free_gtpd fixed bin, 
pd_page_faults fixed bin, 
pd_no_free_first fixed bin, 
update_index fixed bin, 
last_update fixed bin (71), 
count_pdmes fixed bin, 
bucket_overflow fixed bin, 
buckets (0:63) fixed bin, 
ast_track bit (1) aligned, 
dirlock_writebehind fixed bin, 
write _ limit fixed bin, 

pad4 (1) fixed bin; 


/* END INCLUDE FILE sst.incl.plt */ 


*, hard.source 
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pointer to the pd map «/ 

pointer to the pd hash table */ 

pvt index of paging device, O if none */ 

the number of words in.a paging device map entry «/ 
the number of entries in the paging device map «/ 
pointer to head of paging device used list */ 

first usable record of paging device */ 

core address of base of paging device map */ 

number of records in pd map */ 

number of free records on the paging device */ 

actual number of pd records being used */ 

number of read/write sequences queued */ 

total number of read/write sequences ever made */ 
number of times too many rws active at once */ 

total steps taken around-the pd map */ 

number of entries skipped because page was in core */ 
number of entries skipped because a rws was active */ 
total number of pd records needed */ 

times a page was modified while it was being written +/ 
number of pd writes aborted +*/ 

count of current number of active rws’s */ 

number of times couldn’t find a free pd record */ 
number of truncated pages during read of rws */ 
number of truncated pages during write of rws */ 
number of entries in pd hash table */ 

mask used in pd hashing algorithm */ 

pointer to temporary segment for pdmap copying */ 
count of pages truncated because all zero */ 

as above except also on paging device «/ 

tracing control flags */ 


tracing for page faults, done, etc. «/ 


flag used by page control primitives */ . 

flag used by segment control primitives */ 

newly created pages */ 

temporary used for rws metering */ 

time spent initiating rws */ 

time spent finishing up rws */ 

number of hits in the following bins */ 

total residency time for the 4 bins */ 

times pages written to disk because gtpd ON *«/ 
total page faults from pd */ 

times pages were written to disk because first write */ 
temporary used during paging device map update a/ 
time last paging device update was performed */ 
if non-zero, pdme statistics will be kept */ 
counter for overflows */ 

buckets for pdme stats */ 

"4"b => keep SST name table */ 

={ to flush modified dir pages’ in lock$unlock +*/ 
Max # of outstanding writes by page control */ 
padding to 512 words (1000)8 */ 
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sstnt.incl.pli segment in: >»Ildd>include contents modified: 


entry modified: 03/10/82 0836.7 
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/* Begin include file sstnt.incl.pli «/ 


/* Created 10/03/74 by Bernard Greenberg */ 
/* modified 08/24/79 by J. A. Bush for easier calculation of size of sstnt */ 


dcl sst_names $ ext; , /* Segment containing sst name table */ 
dcl  sstnp ptr; /* Pointer to sst name segment */ 
dc! 1 sstnt based (sstnp) aligned, /* Major structure */ 
2 valid bit (1) aligned, ; /* 1 => structure filled by Multics */ 
2 multics_or_bos char (4) aligned, /* Origin of data in table */ 
2 nentries fixed bin, /* number of entries itn the sstnt */ 
2 padi (5) fixed bin, 
2 (ast_sizes, /* Sizes of ASTE’s at each level */- 
ast_name_offsets, /* Starting tndex for names at each level «/ 


ast_offsets, ; /* Starting rel addr of each AST region */ 
pad2) (0 : 3) fixed bin, 


2 names (0 : O refer (sstnt.nentries)) char (32) varying; /* Names of AST entries a/ 
dcl (sstnmx, ptsi_a) fixed bin (17); /* Index into name table */ 
dcl nmm_astep ptr; ' /* astep to be used */ 


/+* End include file sstnt.incl.pli */ 


include.**, hard. source sstnt.incl.pli 
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stack_O data.incl.pli segment : in:  >1dd>include contents modified: 10/03/79 1601.4 
entry modified: 03/10/82 0836.7 : 


/* BEGIN INCLUDE FILE ... stack _O data.incl.pli */ 


/* Created 790509 by Mike Grady */ 


dcgl stack_O data$ fixed bin ext; /* shared stack O data base seg */ 
dcl stack_O data_init_number_of_stacks fixed bin; /* Make PL/I work */ 
dct sdtp ptr; 
dc! 1 sdt aligned based (sdtp), /* stack O database +/ 
2 lock bit (36), /* lock before changing threads */ 
2 num_stacks fixed bin, /* number of stacks in pool */ 
2 freep bit (18), /* head of free thread, managed LIFO */ 
2 pad fixed bin, 
2 stacks (stack_O data_init_number_of_stacks 


refer (sdt.num_stacks)) like sdte; 


dct sdtep ptr; 


dc! 1 sdte aligned based (sdtep), /* stack data table entry */ 
2 nextp bit (18) unal, /* thread to next free entry (if free) +/ 
2 pad bit (18) unal, 
2 astep bit (18) unal, /* ptr to ASTE for this stack seg */ 
2 apntep bit (18) unal, /* ptr to APTE of process using this stack, if not free +*/ 
2 sdw bit (72); /* SOW for this stack seg */ 
/* END INCLUDE FILE ... stack_O data.incl.pit */ 
includ’ **, hard. source stack 0 data.ir '.plt | Page 39 
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stack _frame.incl.plt . segment in: >Idd>include contents modified: 04/13/78 14156.1 
entry modified: 03/10/82 0836.6 


a A A SA eu a nN tt 


/* BEGIN INCLUDE FILE ... stack_frame.incl.plt ... */ 

/* Modified: 16 Dec 1977, OD. Levin - to add fio_ps_ptr and pli_ps ptr +/. 

/* Modified: 3 Feb 1978, P. Krupp - to add run_unit_manager bit & main_proc bit */ 
/* Modified: 21 March 1978, D. Levin - change fio_ps_ptr to support _ptr */ 


dcl sp pointer; /* pointer to beginning of stack frame */ 


dcl stack_frame_min_length fixed bin static init(48); 


dcl 1 stack_frame based(sp) aligned, 
2 pointer_registers(O : 7) ptr, 
2 prev_sp pointer, 
2 next_sp pointer, 
2 return_ptr pointer, 
2 entry_ptr pointer, 
2 operator_and_Ip_ptr ptr, /* serves aS both +*/ 
2 arg _ ptr pointer, 
2 static_ptr ptr unaligned, ; 
2 support _ptr ptr unal, /* only used by fortran 1/0 */ 
2 on_unit_relp1 bit(18) unaligned, 
2 on_unit_relp2 bit(18) unaligned,’ 
2 translator_id bit(18) unaligned, /* Translator IO : 
O => PL/I version II 
1 => ALM 
2 => PL/I version I 
3 => signal caller frame 
4 => signaller frame */ 
2 operator_return_offset bit(18) unaligned, 
2 x(0: 7) bit(18) unaligned, /* index registers +*/ 
2 a bit(36), /* accumulator +/ 
2 q bit(36), /* q-register */ 
2ebit(36), _ /* exponent */ 
2 timer bit(27) unaligned, /* timer */ 
2 pad bit(6) unaligned, 
2 ring_alarm_reg bit(3) unaligned; 
dc! 1 stack_frame_flags based(sp) aligned, ' 
2 pad(O : 7) bit(72), /* skip over prs */ 
2 xxO bit(22) unal, 
2 main_proc bit(1) unal, /* on if frame belongs to a main procedure */ 
2 run_unit_manager bit(1) unal, /* on if frame belongs to run unit manager */ 
2 signal bit(1) unal, /* on if frame belongs to logical signal_ */ 
2 crawl_out bit(4) unal, /* on if this is a signal caller frame */ 
2 signaller bit(1) unal, /* on if next frame is signaller’s */ 
2 link_trap bit(1) unal, /* on if this frame was made by the linker */ 
2 support bit(1) unal, /* on if frame belongs to a support proc */ 
include.**, hard. source stack_frame.incl.plt a ~ Page 100 
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condition bit(1) unal, 
xxOa bit(6) unal, 

xxi fixed bin, 

xx2 fixed bin, 

xx3 bit(25) unal, 


old_craw!_out bit (1) unal, 


old_signaller bit(1) unal, 
xx3a bit(9) unaligned, 
xx4(9) b1t(72) aligned, 
v2_pl1_op_ret_base ptr, 


xx5 bit(72) aligned, 
pli_ps_ptr ptr; 


END INCLUDE FILE ... stack_frame. incl 


/* 


-plt +/ 
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includr +, hard.source 
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on if condition established in this frame */ 


on if this is a signal caller frame */ 
on {f next frame is signailer’s */ 


When a V2 PL/I program calts an operator the 
operator puts a potnter to the base of 
the calling procedure here. (text base ptr) */ 


ptr to ps for this frame; also used by fio. */ 


stack_frame.inc” olf 
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stack_header.incl.plit 


/* BEGIN INCLUDE FILE 

/* modified 7/76 by M. 

/* modified 3/77 by M. 

dc | sb ptr; 

dcl 14 stack_header based 
2 padi (4) fixed 
2 old. lot_ptr ptr, 
2 combined_stat_ptr ptr, 
2 cir_ptr ptr, 
2 max_lot_size fixed 
2 main_proc_itnvoked fixed 
2 run_unit_depth fixed 
2 cur_lot_size fixed 
2 system_free ptr ptr, 
2 user_free_ptr ptr, 
2 null_ptr ptr, 
2 stack_begin_ptr ptr, 
2 stack_end ptr ptr, 
2 lot_ptr ptr, 
2 signal ptr ptr, 
2 bar_mode_sp ptr, 
2 plt_operators_ptr ptr, 
2 call_op ptr ptr, 
2 push_op_ptr ptr, 
2 return_op_ptr ptr, 
2 return_no_pop_op ptr ptr, 
2 entry_op_ptr © ptr, 
2 trans_op_tv_ptr ptr, 
2 isot_ptr ptr, 
2 sct_ptr ptr, 
2 unwinder_ptr ptr, 
2 sys_link_info_ptr ptr, 
2 rnt_ptr ptr, 
2 ect_ptr ptr, 
2 assign_linkage_ptr ptr, 
2 pad3 (8) bit (36) aligned; 


include.+**, hard.source 
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segment in: >Idd>include — contents modified: 04/13/78 1156.1 


entry modified: 03/10/82 0836.6 


stack_header.incl.pli .. 3/72 Bill Silver -+/ 
Weaver for *system links and more system use of areas */ 
Weaver to add rnt_ptr */ 


/* the main pointer to the stack header *+/ 


(sb) aligned, 


bin, * (0) also used as arg list by outward_call_handler — */ 

* (4) pointer to the lot for current ring (obsoleté) */ 

* (6) pointer to area containing separate static */ 

* (8) pointer to area containing linkage sections */ 
bin(17) unal, * (10) DU number of words allowed in lot */ 
bin (11) unal, * (10) OL nonzero if main procedure invoked tn run unit */ 
bin(S) unal, * (10) Di number of active run units stacked */ 
bin(17) unal, * (11) 


number of words (entries) in lot */ 


(12) pointer to system storage area */ 
(14) pointer to user storage area */ 


+/ 


1 

18) 

20) pointer to next useable stack frame */ 
22) 


pointer to first stack frame on the stack */ 


pointer to the lot for the current ring */ 


(24) pointer to signal procedure for current ring */ 


value of sp before entering bar mode */ 
pointer to standard call operator */— . 


(32) pointer to standard push operator */ 
pointer to standard return operator */- 


pointer to standard entry operator +*/ 

* 

+ ) pointer to ISOT */ 

+ (44) pointer to System Condition Table: */ 

* ) pointer to unwinder for current ring */ 
(48) pointer to *system link name table */ 
(50) pointer to Reference Name Table */ 


+ 

* 

* (52) pointer to event channel table */ 
* 

* 


(54) 
(56) for future expansion */ 


stack_header.incl.pli 


) 
(28) pointer to pli_operators_$operator_table */ 
‘ é 


(40) pointer to translator operator ptrs */ 


) 
36) pointer to standard return / no pop operator */ 
) , 


pointer to storage for (obsolete) hcs_$assign_linkage */ 


Page 
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/* The following offset refers to a table within the pl! operator table. */ 


dcl tv_offset fixed bin init(361) internal static; /* (551) octal */ 
/* The following constants are offsets within this transfer vector table. +*/ 
dc} (call_offset fixed bin init(271), 
push_offset fixed bin init(272), 
return_offset fixed bin init(273), 
return_no_pop_offset fixed bin init(274), 
entry_offset fixed bin init(275)) internal static; 
/* The following declaration is an overlay of the whole stack header. Procedures which 
move the whole stack header should use this overlay. 
«/ : 
dc} stack_header_overlay (size(stack_header )) fixed bin based (sb); 
/* END INCLUDE FILE ... stack_header.incl.pl1 */ 
includ  °*, hard.source stack _header.ir *.plit ; “age 103 
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in: >Idd>include 10/ 13/82 


stpck_ seg.incl.plit segment contents modified: 1310.8 
entry modified: 10/13/82 1311.9 
/* START OF: stock_seg.incl.plit Oe / 
dcl stock_segp ptr; 
dc} record_stockp ptr; 
dcl vtoce_ stockp ptr; 
dc} stock_seg$ ext; 
dcl n_in_record_stock fixed bin; 
dcl n_volmap_pages fixed bin; 
dc| n_in_vtoce_stock fixed bin; 
dc) 1 stock_seg aligned based (stock_segp), 
2 meters aligned like rsmeters, 2 
2 record_stock_entries fixed bin, _ . /* Number of entries in a record stock */ 
2 vtoce stock_entries fixed bin, /* Number of entries in a VTOCE stock */ 
2 record_stock_size fixed bin, /* Size of a record stock in words */ 
2 vtoce_stock_ size fixed bin, /* Size of a VTOCE stock in words */ 
2 n_stock_ entries fixed bin, /* Number of stocks of each type: */ 
2 record_stock_arrayp ptr, ' f* Record stock region */ 
2 vtoce stock_arrayp ptr; /* VTOCE stock region */ 
del 1 record_stock aligned based (record_stockp), 
2 pvtep ptr unal, /* PVTE for this stock */ 
2 n_in_stock fixed bin (18) uns unal,/* Max number of addresses in stock */ 
2 n_volmap_pages fixed bin (18) uns unal,/* Number of pages in Volume Map */ e 
2 n_free_in_stock fixed bin (18) uns unal,/* Number addresses currently free */ 
2 n_os_in_stock fixed bin (18) uns unal,./* Number addresses currently out-of-service */ 
2 low_threshold fixed bin (18) uns unal,/* Low threshold for withdrawing from volmap */ 
2 high_threshold fixed bin (18) uns unal,/* High threshold for depositing to volmap */ 
2 target fixed bin (18) uns unal,/* Target for stock */ 
2 stock_offset bit (18) unal, /* Offset of stock in this structure */ 
2 n_words_in_stock fixed bin (18) uns unal,/* Number of words = Number of entries / 2 */ 
2 search_index fixed bin (18) uns unal,/* Roving pointer */ 
2 old_volmap_page (3) aligned, /* N_OLD_VOLMAP_PAGES (cif) */ 
3 last fixed bin (18) uns unal,/* Roving pointer */ 
3 pad bit (18) unal, 
2 volmap_page (n_volmap_pages refer (record_stock.n_volmap_pages)) aligned, 
include.**, hard.source stock seg. incl.pli_ Page 
FBOA - Not to be reproduced 


104 


3 n_free fixed bin (18) uns unal,/* Number free records in this volmap page */ 


3 baseadd fixed bin (17) unal, /* First record address described by this page */ 
2 stock (n_in_record_stock rafer (record_stock.n_in_stock)) bit (18) unal; /* Stock array of addresses * 
/ | : 
/* bit O ON => out-of-service */ 
dcl 1 vtoce_stock aligned based (vtoce_stockp), 
2 pvtep ptr unal, /* PVTE for this stock */ 
2 n_in_stock fixed bin (18) uns unal,/* Max number indices in stock */ 
2 n_free_in_stock fixed bin (18) uns unal,/* Number indices currently free */ 
2 target fixed bin (18) uns unal,/* Target when withdrawing/depositing of 
2 search_tndex fixed bin (18) uns unal,/* Roving pointer */ 
2 stock (n_in_vtoce_stock refer (vtoce_stock.n_in_stock)) fixed bin (17) unal; /* Stock array of VTOCE 1 


ndices */ 


dcl 1 rsmeters altgned based, 
2 async_read_calls fixed bin (35), ' /* Number of asynchronous read attempts +*/ 
2 async_page_reads fixed bin (35), /* Number of times page read was required */ 
2 async_post_io_calls fixed bin (35), /* Number of times read or write posted */ 
2 deposit_calls fixed bin (35), /* Number of times deposit calied */ 
2 async_post_io_time fixed bin (71), /* CPU time posting I/Os (interrupt side) */ 
2 deposit_time fixed bin (71), /* CPU time in deposit (call side) */ 
2 low_thresh_detected fixed bin (35), /* Number of times stock below low threshold «/ 
2 high_thresh_detected fixed bin (35), /* Number of times stock above high threshold */ 
2 low_thresh_fails fixed bin (35), /* Number of times no records in volmap */ 
2 withdraw _stock_steps fixed bin (35), /* Number steps thru stock in withdraw +/ 
2 withdraw_stock_losses fixed bin (35), /* Number lockless losses */ 
2 n_withdraw_attempt fixed bin (35). /* Number attempts to withdraw a page */ 
2 n_withdraw_range fixed bin (35), /* Number attempts to withdraw within range «/ 
2 n_pages_withdraw_stock fixed bin (35), /* Number pages withdrawn from stock */ 
2 n_pages_withdraw_async fixed bin (35), /* Number pages withdrawn from volmap */ 
2 n_v_withdraw_attempts fixed bin (35), /* Number attempts to withdraw from volmap */ 
2 withdraw_volmap_steps fixed bin (35), /* Number steps thru volmap in withdraw */ 
2 deposit_stock_steps fixed bin. (35), /* Number steps thru stock in deposit +/ 
2 deposit_stock_losses fixed bin (35), /* Number lockless losses */ 
2 n_deposit_attempt fixed bin (35), /* Number attempts to deposit a page */ 
2 n_pages_deposit_stock fixed bin (35), /* Number pages deposited to stock */ 
2 n_pages_ deposit _volmap fixed bin (35), /* Number pages deposited to volmap */ 
2 n_v_deposit_attempts fixed bin (35), /* Number attempts to deposit to volmap */ 
2 reset_os_calls fixed bin (35), /* Number calls to reset_os */ 
2 reset_os_losses fixed bin (35), /* Number lockless losses */ 
2 withdraw_calls fixed bin (35), /* Number calls to withdraw */ 
2 withdraw_time fixed bin (71), /* CPU time in withdraw (page-fault) */ 
2 pc_deposit_time fixed bin (71), /* CPU time itn pc_deposit */ 
2 pc_deposit_calls fixed bin (35), ' /* Number calls to pc_deposit */ 
2 pc_deposit_pages fixed bin (35), _ /* Number pages deposited by pc_deposit */ 
2 get_free_vtoce_calis fixed bin (35), /* Number calls to get_free_vtoce */ 
2 return_free_vtoce_call fixed bin (35), /* Number calls to return_free_vtoce */ 
2 deposit_vstock_calls fixed bin (35), /* Number attempts to deposit to vtoce stock */ 
2 deposit_vstock_faitlis fixed bin (35), /* Number times deposit failed */ 
2 withdraw_vstock_calls fixed bin (35), /* Number attempts to withdraw from vtoce stock */ 
includr “*, hard.source stock _seg.incl ‘1 Page 105 
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2 witnhdraw_vstock_fails fixed bin (35), /* Number times withdraw failed +/ 
2 deposit_vtoc_map fixed bin (35), /+* Number times vtoce deposited to map */ 
2 withdraw_check_scav fixed bin (35), /* Number times withdraw checked an address for scavenge */ 
2 withdraw_conflict fixed bin (35), /* Number times conflict found */ 
2 pad (11) fixed bin (35); e 
dc} N_OLD_VOLMAP_PAGES fixed bin init (3) int static options (constant); 
dcl DEFAULT_N_IN_RECORD_STOCK fixed bin init (104) int static options (constant); 
dcl DEFAULT_N_IN_VTOCE_STOCK fixed bin init (10) int static options (constant); 
/* END OF: stock_seg.incl.pl4 oA 
tnclude. **, hard. source Stock _seg.inc!.plt Page 106 
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dol 
( 


dal 


/* 


ne ert A 


incl.plt segment in: >Idd>include contents modified: 04/02/70 1914.7 
entry modified: 03/10/82 0836.4 : 

BEGIN INCLUDE FILE ... str.incl.pli ... last modified March 1970 +*/ 

str_seg$ ext, 

strp ptr; 

1 str based (strp) aligned, /* segment or process trailer declaration */ 

2 fp bit (18), /* forward ast trailer re) pointer */ 

2 bp bit (18), /* backward ast trailer rel pointer+/ 

2 segno bit (18), /* segment number +/ . 

2 dstep bit (18)) unaligned; /* rel pointer to ring O dste */ 

stra (0:8000) bit (72) based (strp) aligned: 

END INCLUDE FILE ... str.incl.plt */ 

inclue “*, hard. source str.incl.plt “age 107 
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| a RR NA A A A RY AA NF a 


tc_data.cds . segment in: >Idd>hard>source 
contents modified: 01/26/83 1347.1 


/* AOR ORR ORR ROR ORO HOR ACR OR OR ORR OK OR ROR Be Or 


* * 
* Copyright, (C) Honeywell Information Systems Inc., 1982 * 
* * 


HORROR ROR HORROR ROR ORR ROR ROR UR HOAOHOROHOR BOR ROK ROR ROKR OR ORO OF OROR AOK R OK «f/f 
/*« TC_DATA - This is the Traffic Controller Database. */ 
/* Last modified (Date and reason): 
2/6/76 by S. Webber Initial coding 
6/20/79 by Mike Grady to init max_maxe 
3/4/81 by J. Bongiovanni not to set prds_length (it’s done from the header 
or the TBLS Config Card) 
3/21/81 by JU. Bongiovanni for max_stopped_stack_0O, initialization NTO, 
response time metering 


6/27/81 by J. Bongiovanni for tuning parameter changes (-tcpu, +tpre_empt_sample_time, 


gp_at_notify and gp_at_ptlinotify off by default 
1/82 BIM for stk truncation tuning parms. 
4/27/82 by J. Bongiovanni to change post_purge to OFF 
August 1982, J. Bongiovanni, for realtime_io parameters 


+/ 

/* TORR OR RRO OR OR OR RONG RRR ROR OR ORR ROR ROK OK OR ORK OR Ok a ok ok ee 
* * 
* * 
* Copyright (c) 1972 by Massachusetts Institute of * 
* Technology and Honeywell Information Systems, Inc. * 
* * 
* , * 


OR ROR RRO ROIOR OR ROR OR OR HOR KHOR HOR BOR OR RORK BO KOR KR OE EK «/ 
tc data: proc; 
/* This program creates the tc_data base *«/ 
/* Automatic */ 
dcl 1 cdsa aligned like cds_args; 
dcl code fixed bin (35); 
dcl big time fixed bin (71); 
/* Based */ 
dcl 1 tc_data aligned like tcm based (tcmp); 
/* Static */ 


dcl exclude_pad (1) char (32) aligned static options (constant) init ("pad*"); 


/* Builtins */ 


include.*+*, hard.source tc_data.cds . 
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system id: 
entry modified: 


37-15 


03/27/83 


1807.2 


Page 
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dc! (addr, bin, null, rel, size, string, unspec) builtin: 
/* Entries */ 


dcl com_err_ entry options (variable); 

dc! create data_segment_ entry (ptr, fixed bin (35)); 

dcl get_temp_segment_ entry (char (+), ptr, fixed bin (35)); 

dc) release_temp_segment_ entry (char (*), ptr, fixed bin (35)); 


en i rr tg te rt re rE at ete 


includ *, hard.source tc_data.cds “ye 109 
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call get_temp_segment_ ("“tc_data", tcmp, code); 
/* Check offsets assumed by BOS */ 


call check_offset_for_bos (addr (tc_data.apt_offset), 171, “apt_offset"); 
call check_offset_for_bos (addr (tc_data.apt_size), 203, "apt_size"); 
call check_offset_for_bos (addr (tc_data.apt_entry_size), 215, “apt_entry_size"); 


tc_data.apt_offset = rel (addr (tc_data.apt)); 
tc_data.apt_lock = -1; /* 
tc_data.metering lock = -1; /* 
tc_data.working_set_factor = #; 

tc_data.ncpu = QO; 

tc_data’.itt_size = 155; 

tc_data.dst_size = 155; 

tc_data.initializer_id = (36)°1"b; 
tc_data.max_eligible = 6*262144; 
tc_data.max_max_eligible = 16*262144; 
tc_data.max_stopped_ stack_O = 4; 
tc_data.apt_entry_size = size (apte); 

tc_data.pds_ length = 1024; 


-1 = unlocked */ 
O = locked */ 


tc_data. interactive_q.fp = rel (addr (tc_data. interactive_q)); 
tc_data.interactive_q.bp = rel (addr (tc_data. interactive_q)); 
tc_data.interactive_q.sentinel = (36)"1"b; 


tc_data.max_hproc_segno = 191; /* largest (default) hardcore segment number */ 
tc_data.dst_ptr = null; . 
tc_data.old_user = null; ° 


tc_data.tefirst = 2000000; 

tc_data.telast = 2000000; 

tc_data.timax = 8000000; 
tc_data.process_initial quantum = 2000000; 


tc_data.gp_at_notify = 0; /* off by default */ 
tc_data.gp_at_ptinotify = 0; "J off by default *+/ 
tc_data.pre_empt_sample_time = 40000; /* 40 milliseconds «/ 


tc_data.max_timer_register = 40000; 


tc_data.sort_to_elhead = 
tc_data.auto_tune_ws = 1; 
tc_data.ocore = .Otb; 
tc_data.stk_truncate = "1i"b; 
tc_data.stk_truncate_always = “O"b; 


1; 


/* See fast_hc_ipc, but the rolling average of steps/block is:calculated */ 
/* as NEW_AVERAGE = factor*NEW_VALUE + (1-factor)*OLD_AVERAGE */ 


tc_data.stk_trunc_avg f1 = 0.9375; /* 15/16 */ 
tc_data.stk_trunc_avg f2 = tb - tc_data.stk_trunc_avg f1; 


tc_data.lock_error_severity = 3; /* BEEP BEEP but no crash */ 


include. **, hard.source ~ te _data.cds ) Page 110 
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tc_data. 
tc_data. 
tc_data. 


tc_data. 
tc_data. 
tc_data. 


tc_data. 
te_data. 
tc_data. 


tc_data. 
tc_data. 
tc_data. 


tc_data 


unspec (big time) = 
tc_data. 
tc_data. 
tc_data. 
tc_data. 
-disk_polling_time = big time; 
tc_data. 
tc_data. 
tc_data. 
tc_data. 
tc_data. 
tc_data. 


tc_data 


tc_data 


tc_data. 
tc_data. 
tc_data. 


tc_data 


tc_data. 
tc_data. 


tc_data 


realtime_q.fp = rel (addr (tc_data.realt:ime_q)); 
realtime_q.obp = rel (addr (tc_data.realtime_q)); 
realtime_q.sentinel = (36)"1"b; 


eligible _q head.fp = rel (addr (tc_data.eligible q tail)); 
eligible q head.bp = "0O"b; 
eligible _q head.sentinel = (36)"1"b; 


eligible _q tail.fp = rel (addr (tc_data: idle_ tail)); 
eligible q tail.bp = rel (addr (tc. data. eligible. q_ head) );- 
eligible q _tail.sentinel = (36)" 1"b; 


idle _tail.fp = “O"b; 
idje_ tatl.bp = rel (addr (tc_data.eligible _q_ tat))): 
idle tail.sentinel = (36)"1"b; 


-min_eligible = 2*262144; 
tc_data. 
tc_data. 
tc_data. 
tc_data. 


guaranteed _elig_ inc = 250000; 
priority _sched_inc = 80000000; 
int_q_enabled = 1; 


fnp_buffer_threshold = 30; /* fnp tries to keep > this many free buff */ 


end_of_time = big time; 
next_alarm_time = big time; 
priority_sched_time = big time; 
tty_polling time = big time; 


/* gets zeroed by tc_init$part_2 «/ 


tape polling time = big time; 
imp_polling time = big time; 
mos_polling time = big time; 
volmap_polling_time = big time; 
realtime_io_deadline = 0; 


realtime_io_ quantum = 5000; /* 5 milliseconds */ 


-max_channels = 6; 


init_wait_timeout = 5000000; /* 5 second NTO during initialization 
init_timeout_severity = 0; /* beep 
vcpu_response_bounds_size * VCPU_RESPONSE_BOUNDS; 


.vcpu_response_bounds (1) = 500000; /* 1/2 second 
vcpu_response_bounds (2) = 1000000; /* 14 second 

vepu_response_bounds (3) = 10000000; /* 10 seconds 
.default_procs_required = (8) "1"b; /* all CPUs */ 


/* Now set up call to create data base *«/ 


include 


F8OA* 


cdsa.sections (1).p = addr (tc data); 
cdsa.sections (1).len = size (tc _data); 
cdsa.sections (1).struct_name = “tc_data"; 


cdsa.seg name = “tc _data*; 
cdsa.num_exclude_ names = 1; 
cdsa.exclude_array_ptr = addr (exclude_pad); 


*, hard.source tc_data.cds 
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“COCOOOOOOOOOOOOOOOOO A AAAATTANIAATTTATNNTTANATANNTTTAT ATTAIN ETAT tt b; 


7a 


string (cdsa.switches) = “O"b; 
cdsa.switches.have_text = "t"b; 


call create _data_segment_ (addr (cdsa), code); 


call release_temp_segment_ (“tc_data", tcmp, code); 


include.**, hard. source | ~ t¢_data.cds ; Page 112 
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check_offset_for_bos: 
proc (item_ptr, bos offset, item_name); 


dcl item_ptr ptr; /* pointer to item in tc_data of 
dcl bos offset fixed bin (18); /* ltocation assumed by BOS : +/ 
dcl ittem_name char (*); /* name of item in structure «/ 


if bin (rel (item_ptr)) *= bos_offset. 
then call com_err_ (0, “tc_data", “*a not at BOS-assumed offset (“d=“*oo0)", 
item_name, bos offset, bos offset); 


end check_offset_for_bos; 


includr —*, hard. source tc_data.cds j Page 143 
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% include cds_args; 


include. **, hard.source tc_data.cds - . Page 114 
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% include apte; 


includ: 


F80A ~ 


*, hard. source 
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*% include tcm; 


end tc_data; 


(| tN en Re 


include, **, hard.source tc_data.cds ; Page 116 
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ne act te ee Pat ne 


tom. tncl.plit segment in: >Idd>include contents modified: 10/27/82 1226 
entry modified: 10/27/82 1226.4 

/* BEGIN INCLUDE FILE tcom.incl.pli . used to generate tc_data cds */ 

/* NOTE -- This tnclude file has TWO counterparts in ALM: tc_meters.inct.alm and */ 


/* wete.incl.alm. They cannot be produced with cif, and must be kept up to date manually. */ - 


dcl 


dcl 


NNN MHA HH NWN DAD BD oo 


RMD DP 


BNONHHMHR YON NH DY NN NAN DP 


tcmp ptr; 


tcm aligned based (tcmp), 
pad_base (3) fixed bin (18), 
cid2 fixed bin (18), 

cid3 fixed bin (18), 

cid4 fixed bin (18), 

depth count fixed bin (18), 
loadings fixed bin (18), 


blocks fixed bin (18), 
wakeups fixed bin (18). 
waits fixed bin (18), 
notifies fixed bin (18), 
schedulings fixed bin (18), 
interactions fixed bin (18), 
avequeue fixed bin (35, 18), 
te_wait fixed bin (18), 


te_block fixed bin (18), 
te_i_stop fixed bin (18), 
te_pre_empt fixed bin (18), 
p_interactions fixed bin, 
idie fixed bin (71), 
mp_idle fixed bin (71), 


nmp_idle fixed bin (71), 
zero_idle fixed bin (71), 
lVast_time fixed bin (71), 
loop_locks fixed bin (18), 
loop_lock_time fixed bin (18), 
ave eligible fixed bin (35, 18), 
sort_to_elhead fixed bin (18), 
processor_time fixed bin (71), 
response_time fixed bin (71), 
eligible time fixed bin (71), 
response_count fixed bin, 
eligible count fixed bin, 
quit_counts (0:5) fixed bin, 
loading_idle fixed bin (71), 
delta_vcpu fixed bin (71), 
post_purge_switch fixed bin, 
time_out_severity fixed bin, 


enn emeemasieeeemematumneannneemenemmae ennai een ea 


include *«*, hard.source 
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tcm.incl.pli 


stat moved from here .. */ 


depth last process run */ 
number of process loadings */ 


number of calls to block */ 
number of calls to wakeup */ 
number of calls to wait */ 

number of calls to notify */ 


number of interactive schedulings */ 
recent time average of number in queue */ 
times te called from wait */ 


times te updated from block */ 
times te updated from {_stop */ 


‘times te updated from pre_empt */_ . 


times interaction bit turned off because of high priority */ 
total idie time */ 
multi-programming idle */ 


non-multi-programming idle time */ 

zero idle time */ 

last time a process was run */ 

times looped on the APT lock */ 

time looping on the APT lock */ 

average length of eligible queue */ 

O=> no one,{ => int’ve only, 2 => everybody */ 
total processor time on system */ 
estimate of response time */ 

estimate of eligible time */ 

count of response meters */ 

count of eligible meters */ 

array of buckets indexed by state */ 
loading _idle time +*/ 

delta virtual CPU time for the system */ 
ON if post purging is to be done */ 
syserr first arg for notify time outs */ 


.2 


Page 


RRM HHH DPD lO 


notify check fixed bin, 

quit priority fixed bin, 
iobm_polling time fixed bin (71), 
end_of_time fixed bin (71), 
gp_at_notify fixed bin (18), 
gp_at_ptInotify fixed bin (18), 
int_q_enabled fixed bin (18), 


fnp_buffer_threshold fixed bin (18), 


/* 100 octal */ 


RM bo 


PMB DH YH HH HNN DPD bf bo 


2 


depths (8) fixed bin (18), 
tdepths (8) fixed bin (71), 
pfdepth (8) fixed bin (18), 


ptl_not_waits fixed bin (18), 
gw_gp_window_count fixed bin (18), 
metering lock fixed bin (18), 
ptl_waits fixed bin (18), 
gp_start_count fixed bin (18), 
gp_done_count fixed bin (18), 
nto_check_time fixed bin (71), 
nto_delta fixed bin (35), 
nto_count fixed bin (18), 
tcpu_scheduling fixed bin (18), 
nto_event bit (36), 

page notifies fixed bin (18), 
notify nobody count fixed bin (18), 
notify nobody event bit (36), 
system_type fixed bin, 


stat (0:15) fixed bin (18), 


/* 200 octal +*/ 


2 


fh 


ND BH RD BD fb fo 


include. **, 


FBOA 


wait (8), 
3 time fixed bin (18), 
3 count fixed bin (18), 


ready (8), 
3 time fixed bin (18), 
3 count fixed bin (18), 


total_pf_time fixed bin (71), 


total_pf_count fixed bin (18), 
auto_tune_ws fixed bin (18), 
ocore_delta fixed bin (18), 

ws sum fixed bin (18), 

nonidle_ force_count fixed bin (18), 
itt_list_lock bit (36) aligned, 
cpu_pf_time fixed bin (71), 
cpu_pf_count fixed bin (18), 
special_offsets unaligned, 


hard. source 


- Not to be reproduced 


‘tom. incl.plt 


obsolete */ 

factor for scheduler quit response */ 

time to poll tobm +/ 

very large time */ 

O => just do get_idle _processor «/ 

O => just do get_idle_processor */ 

O => no intv q in percent mode «/ 

if fewer free buffs then stingy alloc strategy */ 
set this to >= half n_ttylines/fnp for safety */ 


histogram of run depths */. 
histogram of times run per depth */ 
histogram of page faults per depth +/ 


times ptl_wait noticed pt! was unlocked */ 
times window noticed «/ 
O=locked, else unlocked */ 
num calls to ptl_wait */ 
to detect gw_gp window lossage +/ 


next time at which nto code will be called */ 
microsec between nto checks */ 

number of times nto detected «/ 

obsolete *f 
last event which NTO‘d */ 


used to be tcm.inter */ 


num apte’s in each state */ 


histogram of page fault waiting times versus did */ 


histogram of timas in ready queue */ 


total time spent from start to end of 

all page faults */ 

total number of page faults metered */ 

O=> dont, atherwise compensate for quantum len «/ 
number of pages reserved for int users */ 

total of eligible’s ws_sizes +t/ 

count of eligibilities forced */ 

Lock on ITT free list */ 

total cpu time spent handling page faults */ 
total count of cpu time meterings */ 


Page 
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2 


3 apt_offset bit (18), 

3 pad bit (18), 

getwork_time fixed bin (71), 

getwork_count fixed bin (18), 
short_pf_count fixed bin (18), 
interrupt_time fixed bin (71), 
interrupt_count fixed bin (71), 

ocore fixed bin (35, 18), 

pre_empt_flag bit (36) aligned, 
cumulative _memory_usage fixed binary (71), 


processor_time_at_define_wc fixed bin (71), 


boost_priority fixed bin, 
lost_priority fixed bin, 
total_clock_lag fixed bin (71), 
clock_simulations fixed bin, 
max clock. lag fixed bin, 


/* 300 octal */ 


includ 


F8On 


pdscopy! fixed bin (18), 
max_hproc_segno fixed bin, 
prds_length fixed bin (18), 
pds_length fixed bin (18), 

lock fixed bin (18), 

id fixed bin (18), 
system_shutdown fixed bin (18), 
working _set_factor fixed bin (35, 18), 
ncepu fixed bin (18), 

last_eligible bit (18), 

apt_lock fixed bin (35), 

apt_size fixed bin (18), 

realtime_q aligned like based_sentinel, 
aht_size fixed hin (18), 

itt_size fixed bin (18), 


dst_size fixed bin (18), 
itt_free_list bit (18), 

used_itt fixed bin (18), 
initializer_id bit (36) aligned, 
n_eligible fixed bin (18), 
max_eligible fixed bin (30), 
wait_enable fixed bin (18), 
apt_entry_size fixed bin (18), 


interactive_q aligned like based_sentinel, 
dst_ptr ptr, 

old_user ptr, 

initialize _time fixed bin (71), 


init_event fixed bin (18), 
oldt fixed bin (18), 

newt fixed bin (18), 
tefirst fixed bin (30), 
telast Fixed bin (30), 


“*, hard. source 


ot to be reproduced 


tem. incl.plt 


total time spent in getwork */ 

total times through getwork */ 

number of short page faults */ 

total time spent in interrupt */ 

total number of metered interrupts */ 

fraction of core for int’ve users */ 

controls whether preempting at done time */ 

total number of memory usage units */ 

value of processor_time when WC’s last defined */ © 
number of times priority process given high priority */ 
number of times priority process lost eligibility */ 
sum of all simulated clock delays */ 

number of times alarm clock interrupt was simulated */ 
largest simulated alarm clock delay */ 


amount of pds to copy for new process */ 
largest allowed hardcore segment number */ 
length of PROS */ 

length of PDS *«/ 

process id generator lock */ 

next processid to be given out */ 


working set factor */ 


number of processors currently being used */ 

last process to gain eligibility */ 

+ write; O hidden; -1 unlocked; -(N+1) Nreaders */_ 
number of APT entries */ 

processes with realtime deadlines */ 

APT hash table size */ 

number of ITT entries */ 


number of allowed DST entries */ 

pointer to ITT free list */ 

number of used ITT entries */ 

process id of inittalizer +*/ 

number of processes eligible */ 

maximum allowed number of eligible processes */ 
turned on when waiting mechanism works «/ 

size of an APT entry */ 


head of interactive queue */ 
pointer to device stgnal table *«/ 
last process to run (apt ptr ) «/ 
time of inittalization */ 


wait event during initialization */ 
timer reading from previous process */ 
timer setting for new process */ 

first eligible time */ 

jast eligible time */ 


18 
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2 timax fixed bin (35), /* 
2 empty_q bit (18), /* 
2 working _set_addend fixed bin (18), /* 
2 ready_q_head bit (0) aligned, /* 
2 eligible _q head aligned like based_sentinel, /* 
2 ready _q_tail bit (0) aligned, /* 
2 eligible _q tail aligned like based_sentinel, /* 
2 idie_ tail aligned like based_sentinel}l, /* 
2 min_eligible fixed bin (30), 

2 alarm_timer_list bit (18) aligned, /* 
2 guaranteed _elig_inc fixed bin (35), /* 
2 priority_sched_inc fixed bin (35), /* 
2 next_alarm_time fixed bin (71), _f* 
2 priority _sched_time fixed bin (71), /* 
2 tty_polling_time fixed bin (71), /* 
2 disk_polling_time fixed bin (71), /* 
2 tape polling_time fixed bin (71), - [* 
2 imp_polling_time fixed bin (71), /* 
2 imp_polling_lock fixed bin (18), /* 
2 max_channels fixed bin (18), /* 


/* 400 octal */ 


include.+**, hard.source tom. incl. pit 
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time in queue for lowest level */ 
thread of empty APT entries */ 
additive working set parameter */ 
for added segdef */ 

head of eligible queue +/ 

for added segdef */ 

tail of eligible queue */ 

tall of idle list */ 


rel pointer to apt entry for next alarm timer */ 
anount of guaranteed eligibility time in microsecs. */ 
amount of block time before process is given priority */ 
clock time for next alarm timer */ 

time for priority process to be given priority */ 

time to poll TTY DIM */ 

time to poll disk DIM */ 

time to poll tape DIM */ 

time to poll imp */ 

do not poll if lock set */ . 

num special channels per process */ 


2 system_virtual_time fixed bin (71), /* non-idle virtual time */ 

2 credit_bank fixed bin (71), /* credits not yet passed out */ 

2 min_wct_index bit (18) aligned, /* offset of initializer work class table entry */ 

2 max_wct_index bit (18) aligned, /* offset of highest wete currently defined */ 

2 delta_vt fixed bin (71), - /* temp used by pxss.compute_virtual_clocks */ 

2 gross_idie_time fixed bin (71), /* idle time_used_clock */ 

2 credits _per_scatter fixed bin (35), /* total number of credits awarded at once */ 

2 best_credit_value fixed bin (18), /+ temp for pxss.find_next_eligible */ 

2 define_wc_time fixed bin (71), /* clock time when workclasses last degined */ 

2 max_batch_elig fixed bin (35), 

2 num_batch_elig fixed bin (35), 

2 deadline_mode fixed bin (35), _/* O=> ti sorts, else deadline sorts */ 

2 credits scattered fixed bin (35), ‘ 

2 max_max_eligible fixed bin (30), , /* Maximum of maxe */ 

2 max_stopped_stack_O fixed bin (35), /* Maximum stack_O’s suspended by stopped procs +/ 
2 stopped_stack_O fixed bin (35), /* Number stack_O’s suspended by stopped procs «f 
2 mos_polling_interval fixed bin (35), ° /* for heals */ 

2 mos_polling time fixed bin (71), /* for heals */ 

2 vcpu_response_bounds (VCPU_RESPONSE BOUNDS) fixed bin (35), 

2 vcpu_response_bounds_size fixed bin (35), 

2 meter_response_time_calls fixed bin (35), 

2 meter_response_time_invalid fixed bin (35), 

2 meter_response_time_overhead fixed bin (71), 

2 init_wait_time fixed bin (71), -  /* used by wait/notify during initialization +/ 
2 init_wait_timeout fixed bin (71), /* notify-timeout interval during initialization */ 
2 init_timeout_severity fixed bin, ; /* notify-timeout severity during initialization */ 
2 init_timeout_recurse fixed bin, _ /* count of NTO recursion during initialization */ 
2 max_timer_register fixed bin (71), /* max cpu burst = #4 cpus x pre_empt_sample_time = */ 
2 pre_empt_sample_time fixed bin (35), /* tuning parameter - max time between samples af 
2 governing credit_bank fixed bin (35), /* used for. limiting eligibility on governed work classes*/ 
2 process_initial quantum fixed bin (35), /* eligibility quantum first eligibility +f 
2 default_procs_required bit (8) aligned, /* default mask of CPUs required */ 
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2 work_class_idie fixed bin (71), /* idle time due to work class restrictions */ 


/* Tuning Parameters for Stack Truncation */ 


2 stk_truncate bit (1) aligned, : 

2 stk_truncate_always bit (1) aligned, 

2 stk_trunc_avg_f1 fixed bin (35, 18), 

2 stk_trunc_avg f2 fixed bin (35, 18). 

2 lock_error_severity fixed bin, /* syserr severity +/ 

2 gv_integration fixed bin (35), /* Integration interval for governing */ 

2 gv_integration_set bit (1) aligned, /* ON => gv_integratton set by ctp */ 

2 pad’ fixed bin (35), 

2 volmap_ polling time fixed bin (71), 

2 padd fixed bin (71). 

2 realtime_io_priority_switch fixed bin, /* O => give I/O interrupt wakeups realtime priotiry */ 
2 realtime_io_ deadline fixed bin (35), /* Delta to clock for 1/0 realtime deadline */ 
2 realtime_io_quantum fixed bin (35). /* Quantum for 1/0 realtime burst */ 

2 realtime_priorities fixed bin (35), : /* Count for metering */ 

2 relinquishes fixed bin (35), /* Calls to relinquish priority */ 

2 abort_ips_mask bit (36) aligned, /* IPS mask for tc_util$check_abort */ 


/* 500 octal */ 

2 padS (192) fixed bin (35), /* room for expansion compat ibly «/ 
/* 1000 octal */ | 

2 pad7 (64) fixed bin (35), 
/* 1100 octal */ 

2 padé (8) Fixed bin (35), 

2 work_class_ table aligned, /* array of per workclass information */ 

3 wete (0:16) aligned like wet_entry, 

/* 3000 octal */ 

2 apt fixed bin; 


del wetep ptr; 


dcl 1 wet_entry aligned based (wctep), /* Work class entry */ 
2 thread unaligned, /* Ready list */ 
3 fp bit (18), /* Head of ready list *«/ 
3 bp bit (18), /* Tail of ready list */ 
2 flags unaligned, 
3 mnbz bit (1), /* Sentinel bit must not be zero. */ 


3 defined bit (1), 

3 lo_priority bit (1), 

3 governed bit (1), 

3 Interactive_q bit (1), 
3 pad bit (31), 


2 credits fixed bin (35), /* Current worthiness of group */ 
2 minf fixed bin (35), /* min fraction of cpu */ 
‘include «*, hard. source tom. incl.pit Page 121 


Fa wt to be reproduced 


pin_weight fixed bin (35), /* number of cycles to pin pages */ 
eligibilities fixed bin (35), /* Count of eligibiltttes awarded */ 
cpu_sum fixed bin (71), /* CPU used by members */ 

resp! fixed bin (71), , 
resp2 fixed bin (71), 
quantumt fixed bin (35) 
quantum2 fixed bin (35), 

rmetert fixed bin (71), 

rmeter2 fixed bin (71), 

rcount! fixed bin (35), 

rcount2 fixed bin (35), 

realtime fixed bin (35), 

purging fixed bin (35), 

maxel fixed bin (35), 

nel fixed bin (35), 

number _thinks fixed bin (35), /* number times process entered “think” state 
number_queues fixed bin (35), /* number times process entered “queued” state 
total _think_time fixed bin (71), er ee 

total queue time fixed bin (71), 


RHP NHP DNPH D NHN AHH AH LHD NH DH 


/*+ The next three arrays correspond to the array vcpu_response_bounds 


number _ processing (VCPU_RESPONSE_BOUNDS+1) fixed bin (35), /* number times entered "processing" state 
total _processing_time (VCPU_RESPONSE_BOUNDS+1) fixed bin (71), - 

total _vcpu_time (VCPU_RESPONSE_BOUNDS+1) fixed bin (71), 

maxf fixed bin (35), /* maximum fraction of cpu time 

governing credits fixed bin (35), /* for limiting cpu resources 

padi (4) fixed bin (35); S 


RAR PR A fo 


dc} based_sentinel aligned based, /* format of pxss-style sentinel */ 
fp bit (18) unal, 
bp bit (18) unal, 


sentinel bit (36) aligned; 


RO NS RD ow 


dcl VCPU_RESPONSE BOUNDS fixed bin init (3) int static options (constant); 


/* END INCLUDE FILE tcm.incl.plii «*/ 


include.+*, hard. source tom. incl.pli | 
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*/ 
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*/ 
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enn en en eer 


vol_map.inc!.pii 


/* BEGIN INCLUDE FILE ... vol_map. incl.plt «/ 
dcl vol_mapp ptr; 
dct 1 vol_map based (vol_mapp) aligned, 


2 n_rec fixed bin(17), 

2 base _add fixed bin(17), 

2 n_free_rec fixed bin(17), 

2 bit_map_n_words fixed bin(17), 
2 pad (60) bit(36), 

2 bit_map (3*1024 - 64) bit(36) ; 


/* END INCLUDE ... vol_map */ 


segment in: 


>1Idd> include contents modified: 02/24/76 


entry modifted: 03/10/82 0836.5 


2027.5 


/* number 
/* record 
/* number 
/* number 
/* pad to 
/* bit ma 


ee rumemertncmmempmtamamereannstine amen metre 
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vol_map.incl.p 


of records represented in the map */ 

number for first bit in bit map */ 

of free records */ 

of words of the bit map */ 

64 words */ 
p - the entire vol map occupies 3 records */ 


{23 


vtoc_buffer. 


/* START OF: 


dc} 


dc}\ 
dc} 
dc} 
dcl 
dc} 


dc} 
dc\ 


dc} 


incl.plt 


vtoc_buffer_seg% 


vtoc_buffer_segp 
vtoc_ buf _descp 
vtoc_bufp 

vtoc_ buf, desc_arrayp 
vtoc_buf_arrayp 


vtoc_buf_n_buffers 
vtoc buf _n_buckets 


1 vtoc_buffer 


2 lock, 
3 processid 
3 wait_event 
3 notify_sw 


2 n_bufs fixed bin, 

2 n_hash_buckets fixed bin, 

2 hash_mask bit (36) aligned, 

2 abs_adar fixed bin (24), 

2 wait_event_constant fixed bin (36) uns unal 

2 buf_desc_offset bit (18), 

2 buf_offset bit (18), 

2 hash_table_ offset bit (18), 

2 search_index fixed bin, 

2 unsafe_pvtx fixed bin, 

2 scavenger_free_p_ clock 

fixed bin (35), 

2 meters, 
3 call_get fixed bin (35), 
3 call_put fixed bin (35), 
3 call_alloc fixed bin (35), 
3 call_free fixed bin (35), 
3 call_await fixed bin (35), 
3 steps fixed bin (35), 
3 skip_os fixed bin (35), 
3 skip_hot fixed bin (35), 
3 skip_wait fixed bin (35), 
3 disk_reads fixed bin (35), 
3 disk_writes fixed bin (35), 
3 get_buffer_calls fixed bin (35), 
3 get_buffer_hits fixed bin (35), 
3 wait_calls fixed bin (35), 
3 wait_os fixed bin (35), 


segment 


in: >Ildd>include contents modified: 11/19/82 1602.2 


entry modified: 11/19/82 1604.3 


vtoc_buffer.incl.plit November , 1982 


ext; 


ptr; 
ptr; 
ptr; 
ptr; 
ptr; 


fixed bin; 
fixed bin; 


bit (36) aligned, 
bit (36) aligned, 
bit (1) aligned, 


a ee ee 9d 


_ aligned based (vtoc_buffer_segp), 


Global jtock for vtToc buffers s/f 
Owner */ 


“For lock */ se 


ON => notify on unlock */ 


Number of full VTOCE buffers */ 
Number of hash table buckets */ 
Mask for hash algorithm +*/ 
Absolute address of vtoc_buffer_seg */ 
/* Constant to add to part index to form wait event */ 
Offset of buf_desc */ 
Offset of buf */ . 
Offset of hash_table */ 
Roving pointer for buffer selection */ 
PVTE index with update in progress */ — 


Pseuda-Clock for scavenger-free-other-allocate race */ 


Calls to get_vtoce */ 

Calls to put_vtoce +«/ 

Calls to alloc_and_put_vtoce */ 
Calls to free_vtoce */ 

Calls to await_vtoce */ 

Steps through buffer allocation */ ; 
Skipped because out-of-service */ 
Skipped because buffer hot +/ 
Skipped because notify sw set */ 
Number of same */ 

Number of same */ 

Number of calls to GET _BUFFER ry, 
Number times VTOCE in buffer */ 
Number of calls to WAIT */ 

Number of times had to wait */ 


ete te me ttre tere aenen eth te tn pr errs tt a fn tenet heel ence ant Papa a ont rN nr her setter nat nh ep isp ff pr ene 
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include, **, 


hard.source 
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3 scavenger_free_checks 
fixed bin (35), 
3 scavenger_free_losses 
fixed bin (35), 


/* Number of times had to check pseudo-clock */ 


/* Number of times race lost between scavenger freeing and other allocat 


refer (vtoc_buffer.n_hash_buckets)) bit (18) aligned, 


(vtoc_buf_n_buffers refer (vtoc_buffer.n_bufs)) aligned like vtoc_buf_desc, 


(vtoc_buf_n_buffers refer (vtoc_buffer.n_bufs)) aligned like vtoce_buffer; 


(vtoc_buffer.n_bufs) aligned based (vtoc_buf_desc_arrayp) like vtoc_buf_desc; 


aligned based (vtoc_tuf_descp), 


/* PVTE tndex */ 


/* VTOCE Index. */ 

/* Mask of parts used or os */ 

=> 1/0 error on buffer */ 

=> notify requied on 1/0 completion */ 
=> write 1/0 */ 

=> 1/0 in progress */ 

=> 1/0 has been requested */ 

=> this descriptor is in use */ 


/* Buffer index for forming wait event */ 
_/* Offset of next entry in hash table +/ 
/* Offset of buffer in segment */ 


(vtoc_buffer.n_bufs) aligned based (vtoc_buf_arrayp) tike vtoce_buffer; 


aligned based (vtoc_bufp), 


aligned; 


static 
static 
static 
static 
static 


e */ 
3 pad (15) fixed bin (35), 

2 hash_table (vtoc_buf_n_buckets 
2 buf_desc 
2 buffer 

dcl 1 vtoc_buf_desc_array 

del 1 vtoc_buf_desc 
2 pvtx fixed bin (17) unal, 
2 vtocx fixed bin (17) unal, 
2 parts _used bit (3) unal, 
2 err bit (1) unal, 
2 notify_sw bit (1) unal, 
2 write_sw bit (1) unal, 
2 os bit (1) unal, 
2 ioq bit (1) unal, 
2 used bit (1) unal, 
2 pad bit (9) unal, 
2 wait_index fixed bin (17) unal, 
2 ht_thread bit (18) unal, 
2 buf_rel bit (18) unal; 

del 1 vtoce_buffer_array 

dc} 1 vtoce_buffer 
2 parts (3) aligned, 

3 words (64) bit (36) 

dcl N_PARTS_PER_VTOCE fixed bin int 

dc} VTOCE_ PART _SIZE fixed bin int 

dc} VTOCE _BUFFER _SIZE fixed bin int 

dc! N_ VTOCE _PER_ RECORD fixed bin int 

dcl N_ SECTOR _PER _VTOCE fixed bin int 

/* END OF: vtoc_buffer.incl.pli 


ine ludr 


F8O. 


*, hard.source 
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vtoc_bt 


options 
options 
options 
opt fons 
options 


uUffer. inc 


(constant) 
(constant) 
(constant) 
(constant ) 
(constant ) 


d11 


init (3); 
init (64); 
init (3 * 64); 
init (5); 
init (3); 


*/ 
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vtoc_ header.incl.pit segment in: >Idd>include contents modified: 05/05/77 0832.2 
entry modified: 03/10/82 0836.5 


a ra ey rete emerpe erenrne epte renee terri tetera earns Aan ene Pes RIES nt I Vr 


/* BEGIN INCLUDE FILE ... vtoc_header.incl.pl1 */ 
dcl vtoc_headerp ptr; 


dcl 1 vtoc_header based (vtoc_headerp) aligned, 


2 version fixed bin (17), /* version number. The current version number is 1. * */ 
2 n_vtoce fixed bin (17), /* number of vtoc entries */ 
2 vtoc_last_recno fixed bin (17), /* record number of the last record of the vtoc */ 
2 n_free vtoce fixed bin (17), /* number of free vtoc entries +*/ 
2 first _free_vtocx fixed bin (17), /* index of the first vtoce in the free list */ 
2 pad (3) bit (36), 
2 dmpr_bit_map (2048 - 8) bit (36); /* space for dmpr bit map */ 
/* END INCLUDE ... vtoc_header */ 
includa.**, hard. source vtoc_header.incl.pit. “Page 126 
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vtoc_map.incl.pli segment in: >Idd>include contents modified: 05/20/82 
entry modified: 05/20/82 1047.7 
/* START OF: vtoc_map.inc!.plit ... March 1982 ... 2 «/ 
dc} vtoc_mapp ptr; 
dc} bit _map_wordp ptr; 
dcl 1 vtoc_map aligned based (vtoc_mapp), 
2 n_vtoce fixed bin, /* Number of VTOCEs on the device */ 
2 n_free_vtoce fixed bin, /* Number of free VTOCEs */. 
2 bit_map_n_words fixed bin, /* Number of words in the bit map below +*/ 
2 vtoc_last_recno fixed bin, /* Last record number in VTOQC */ 
2 pad (4) fixed bin, 
2 bit_map (0:1024 - 9) bit (36); /* This structure consumes exactly 1 page */ 
de| 1 bit_map_word aligned based (bit_map_wordp), 
2 padi bit (1) unal, 
2 bits bit (32) unal, /* 32 VTOCES ON => free */ 
2 pad2 bit (3) unal; 
/* END OF: vtoc_map. inc).pit | af 
includ *, hard.source vtoc_map.incl).r “ge 127 
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vtoce.inc!.p}i 


/* BEGIN INCLUDE FILE ...vtoce.inc).plit 

/* Template for a VTOC entry. Length = 192 words. (3 *-64). */ 

dcl vtocep ptr; 

dcl 1 vtoce based (vtocep) aligned, 
(2 pad_free_vtoce_chain bit (36), /* 
2 uid bit (36), /* 
2 msl bit (9), /* 
2 csi bit (9), /* 
2 records bit (9), /* 
2 pad2 bit (9), 
2 dtu bit (36), /* 
2 dtm bit (36), /* 
2 nasw bit (1), /* 
2 deciduous bit (1), /* 
2 nid bit (1), /* 
2 dnzp bit (1), /* 
2 gtpd bit (1), /* 
2 per_process bit (1), /* 
2 damaged bit (1), /* 
2 fm_damaged bit (1), /* 
2 fm_checksum_valid bit (1), /* 
2 synchronized bit (1), /* 
2 pad3 bit (8), 
2 dirsw bit (1), /* 
2 master_dir bit (1), Pe is 
2 pad4 bit (16)) unaligned, /* 
2 fm_checksum bit (36) aligned, /* 
(2 quota (0:1) fixed bin (18) unsigned, /* 
2 used (0:1) fixed bin (18) unsigned, /* 
2 received (0:1) fixed bin (18) unsigned, /* 


2 trp (0:1) fixed bin (71), 


2 trp_time (0:1) bit (36), 


segment 


entry modified: 


>I1dd> include 11/16/82 1454.7 


11/16/82 1456.6 


in: contents modified: 


last modified September 1982 */ 


Used to be pointer to next free VTOCE «/ 
segment’s uid - zero if vtoce is free «/ 


maximum segment length in 1024 word units */ 
current segment length - in 1024 word units */ 
number of records used by the seg in second storage */ 


date and time segment was last used +/ 
date and time segment was last modified */ 


no quota switch - no checking for pages of this seg */ 
true if hc_sdw */ 

no incremental dump switch *+/ 

Dont null zero pages */ 

Global transparent paging device */ 

Per process segment (deleted every bootload) */ 

TRUE if contents damaged *«/ 

TRUE if filemap checksum bad */ 

TRUE if the checksum has been computed «/ 

TRUE if this is a data management synchronized segment */ 


directory switch */ 

master directory - a root for the logical volume */ 
not used */ 

Checksum of used portion of file map */ 

sec storage quota - (0) for non dir pages */ 

sec storage used - (0) for non dir pages */ 
total amount of storage this dir has received */ 


time record product - (0) for non dir pages */ 


time time_record_product was last calculated */ 
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2 fm (0:255) bit (18), /* file map - 256 entries - 18 bits per entry */ 
2 pad6 (10) bit (36), /* not used */ 
ned bit (1), /* no complete dump switch */ 


2 
2 pad7 bit (17), 
2 pad’ bit (18), 


2 dtd bit (36), /* date-tima-dumped */ 
2 volid (3) bit (36), /* volume ids of last incremental, consolidated, and complete dumps */ 
2 master_dir_uid bit (36), ; . /* supertor master directory uid */ 
2 uid _ path (0:15) bit (36), /* uid pathname of all parents starting after the root */ 
2 primary_name char (32), /* primary name of the segment */ 
2 time_created bit (36), /* time the segment was created +/ 
2 par_pvid bit (36), /* physical volume id of the parent */ 
2 par_vtocx fixed bin (17), /* vtoc entry index of the parent */ 
2 branch_rp bit (18)) unaligned, /* rel pointer of the branch of this segment */ 
2 cn_salv_time bit (36), /* time branch - vtoce connection checked */ 
2 access_class bit (72), /* access class in branch */ 
2 perm_flags aligned, 
3 per_bootload bit (1) unal, /* ON => deleted each bootload */ 
3 pad9 bit (35) unal, 


2 owner bit (36); /* pvid of this volume */ - 


del vtoce_parts (3) bit (36 * 64) aligned based (vtocep); 


dcl 1 seg vtoce based (vtocep) aligned, /* Overlay for vtoce of segments, which don’t have quota */ 
2 padi bit (7*36), 
2 usage fixed bin (35), /* page fault count: overlays quota */ 
2 pad2 bit (184+36); ; 
/* END INCLUDE FILE vtoce.incl.plt */ 
include “*, hard.source vtoce. incl.plt P-ge 129 
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APPENDIX 8 


MULTICS TECHNICAL PAPERS 


Multices = Tne First Seven Years ‘ 

Tae Multics Virtual Memory: Concepts “and “Design 

A Simple Linear Model of Demand Paging Performance 
A Hardware Architecture for Implementing Protection 
Rig S > s aie ae 

Tne Multies PL/I Compiler : 4°. yr ni Wet 487. Se. 2 os. % 

Virtual Memory, Processes, and Sharing in Multics 

Introduction and: Overview of tne Multics System 

System Design of a Computer for Time Snaring 
Applications : ‘ 

Structure or the Multies Supervisor : 

A General-Purpose File System for Secondary Storage 

Communications and I/O Switching in a mee 
Computing System. . eee . 

Some tnougnts about tne Social Iaplications of 
Accessiole Computing mie 38 
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8) 19 
7250 TeS55c65 78 
9 706.6 1973 
146-71 
6.48 498.232 
3.46 


24 interactives 22 daemons. 
ve Last 15 sec, 
-039 90.14 70.09 VADIS 
01 9 PS i er at ee a. | 
Oe26 2.16 P-O R IT Init 
VeGG> “tC UP .-R.ot NADLS 
PQ I System Sy 
P 0 I Other 
Ge50 ted oP -O.R 16 
0 0.008 0.0 0 -1 Idle 
0 J. 000 0 0 0 -1 Idle 
0 0.020 34465 9 O 4 Retriev 
0 48.105 090 0 3 Alonso 
0 0.084 273211 0 $C 3 Cintro 
0 0-189 -~400000000000 0 O 1 
9 162.744 0 0 O 3 Figuero 
0 art) 0 90 © O Rios 
0 04164 0 0 0 71 IsteGra 
0 1.442 00 O 1 Caguas 
0.50 .uue 
13679 11.4 
55°35 88 86 
132 300 34 
185 182 97 
195 215 102 
175 263 105 
193 254 110 
226 238 116 
148 1566 135 
347 5095 320 
354 4437 3e7 
1502 2835 982 
3436 5869 2245 
34346 4) 34346 
ee 84.0 
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mem 
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adska 1 adskb 2 
400000 10 20 £60 
sstn 32. str 64. 
75. 299. 
ttyb 14080. ttyq 
bos dska i 
dump dska 1 
log dskb 2 
mspa 451. a 20 4 
mspb 451. a 30 4 
mtpa 601. a 16 1 
urpa 600. a 10 4 
aa 14 
b a 15 
a 7 on adpss 70. 
b 6 on dps8 70. 
dska a 34 2 
dskb a 30 4 
600. 400. 300. 750. 
dcf 
dska a 20 4 451. 
dskb a 24 4 451. 
tapa a 16 2 £500. 
prta a 10 1600. 
prtb a 11 1600. 
rdra a 12 301. 
opca a 37 6601. 
puna a 13 300. 
warm 4 
a O nsa on 
aq 512. on 
ec 512. on 
b 512. on 
a 2048. on 
Cc 
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Drive Records Left % VTOCEs Left % Avg PV PB/PD LV Name 
Size Name 


dska_0O5 36584 1354 4 7625 4605 60 11 cis2 pb cis 
dska_ll 36584 2455 7 7625 4814 63 12 cisl pb cis 
dska_12 36584 6226 17 7625 .4154 54 8 Ilddl pb idd 
dskb_09 36720 27412 75 7650 7592 99 160 progra pb progra 
askb_ 05 36720 2521 7 7650 1986 26 6 publicodl pb pd public 
dskb 06 36720 1954 5 7650 1717 22 #=5. publicd3 pb pd public 
dskb 07 36720 2373 6 7650 1791 23 5 publicod2 pb pd public 
dska_01 29811 1121 4 17400 12774 73 6 rpv pb root 
askb_02 35837 1968 S&S. -7375. ‘2971 39 7 root2 pb root 
dskb_03 36584 2805 8 7625 2987 39 7 root3 pb root 
aska_15 36584 3604 10 7625 5209 68 13 vadis_miScl pb pd vadis mis 
askb 15 36584 5178 14 7625 5478 72 14 vadis_misc2 pb pd vadis mis 
dska_04 37967 182 O 710 562 79 255 vadis_pf7 pb vadis pf 
dska_06 37967 168 0 710 560 79 251 vadis pf5 pb vadis pf 
dska_10 37967 433 1 710 563 79 255 vadis_pf3 pb vadis pf 
dska_13 37967 398 1 710 561 79 252 vadis pf2 pb vadis pf 
dskb 08 38094 299 1 710 561 79 253 vadis_pfl pb vadis pf 
askb_14 37967 60 0 710 561 79 254 vadis_ pf6 pb vadis pf 
dskb_ 16 37967 310 1 710 561 79 252 vadis_pf4 pb vadis pf 
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